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Section 1 



INTRODUCTION 



The 41 1 Series Command Reference manual is intended 
for the programmer who is writing a package of host com- 
puter subroutines to communicate with any TEKTRONIX 
41 1 Series Computer Display Terminal. This manual is 
primarily a reference manual and will be used by the pro- 
grammer more than any other manual once the program- 
mer becomes familiar with the terminal. 

The 4110 Series Host Programmers Manual describes the 
terminal programming considerations and details which a 
programmer must be aware of when preparing the host 
computer subroutine package to communicate with a 41 10 
Series terminal and its options. 

41 10 Series terminals operate in two major modes: TEK 
mode and ANSI mode. Since the syntax of the two modes 
are exclusive and overlapping, this manual separates the 
discussions of the commands sets of these two code sets. 



MANUAL ORGANIZATION 

This manual is divided into eight sections. 

• Section 1 (this section) provides an introduction and 
overview, and lists the conventions used in the manual. 

oeu'LIDI I c. UtfdUl lutso ii ic ayniaX ai iu tjdiciai iui mat \j\ 

41 10 Series commands of both code sets. 

• Sections 3 through 6 are indexing sections, designed to 
make finding a specific command easier. 

• Section 3 contains a functional listing of all 
commands. 

• Section 4 lists the contents of Sections 7 and 8 that 
are not commands by type (i.e., parameter types, 
message types, etc.). 

• Section 5 indexes the commands by escape- 
sequence op codes. 

• Section 6 is a keyword-in-context index. That is, it 
contains an entry for each significant word in a com- 
mand name or syntactic construct name. 



• Section 7 is an alphabetical listing of all TEK mode com- 
mands. This section also includes (alphabetically) a 
description of such things as control characters, keys, 
message formats, parameters, etc. Note that in the 
alphabetic listings, numbers (eg. 4010) follow the other 
listings. 

• Section 8 is an alphabetical listing of the ANSI mode 
commands, and of the control characters that act differ- 
ently in ANSI mode than in TEK mode. 

The remainder of the manual consists of various appendices: 

• Appendix A — ASCii Code Charts — contains a standard 
ASCII Code chart and additional charts which define the 
ASCII characters used for various types of parameters. 

• Appendix B — Int Parameters — contains tables of 
packed int parameters and an algorithm on how to pack 
an int using the tables. 

• Appendix C — Error Codes — contains a complete list- 
ing of error codes. The error codes are listed alphabeti- 
cally by command op codes. 

• Appendix D — Color Coordinates — describes the HLS, 
RBG, CMY, and Machine RGB (41 1 5 only) systems of 
color coordinates used in the 41 1 3 and 41 15 Computer 
Display Terminals. 

• Appendix E — Bit Planes and Surfaces — describes 
aspects of the display systems of the 41 1 Series raster 
terminals. 

• Appendix F — 41 1 5 Default Color Map — a listing of the 
coordinates in RGB mode of the 256 colors in the 41 1 5 
default color map. 
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INTRODUCTION 



MANUAL CONVENTIONS 



RELATED DOCUMENTATION 



In Sections 7 and 8, each command starts on a new page, 
and the command name appears at the top of the page. If 
the command is unique to a particular 4110 Series Terminal, 
the terminal number appears on the right-hand side of the 
page. If the command is option-dependent, the option num- 
ber appears in this location in parentheses. Other manual 
conventions are discussed in Section 2: the section on 
command syntax. 



Other manuals which are available for the 41 1 Series 
terminals include: 

• 41 10 Series Host Programmers Manual 

• Operators Manuals 

• Service Manuals 

• Manuals relating to specific options 

Additional information on PLOT 10 Software which supports 
the 41 10 Series terminals is also available. 

Contact your local Tektronix office for a complete list of 
manuals which are available for your particular terminal. 
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Section 2 



COMMAND SYNTAX 



SYNTAX NOTATION 

All commands to the terminal are sent as a sequence of 
individual ASCII characters. To describe each operation in 
terms of individual characters would be tedious and confus- 
ing. Therefore, a number of notational conventions are used 
throughout this manual. 



Syntax Rules 

In this manual, command syntax is represented using the 
syntax and symbols summarized in Table 2-1 . The following 
paragraphs describe each symbol in detail. 



Table 2-1 
COMMAND SYNTAX SYMBOLS 



Meaning 


Symbol or 
Representation 


Literal characters 

(enter these characters literally) 


Boldface type 


Expressions 

(these words and phrases have special 

meaning; 


Hyphenated 


Specific examples 




Has the following syntax 


= 


Alternate items 
(choose one) 


(] 


Optional items 
(omit or choose) 


[] 


Values which can be repeated n times 





Individual ASCII characters sent to or from the terminal are 
represented in bold face. Snoopy mode mnemonics are 
used to represent ASCII control characters. (See Appendix 
G for a list of these mnemonics and their corresponding 
control characters.) 

For example: 

A The ASCII uppercase "A" character 

a The lowercase "a" character 

E c "Escape" (ESC) control character 

d t "Delete" (DEL) character (also called "rub out") 

°s "Unit separator" control character 

s o "Shift out" control character 

An expression is a word or phrase that has special meaning 
in this manual. Expressions include command names, 
message types, special characters, parameter types, syn- 
tactic constructs, and parameter names. 

Expressions in text are italicized, and if the expression is 
longer than one word, the words are joined by hyphens. 
This is true for all parameters and syntactic constructs 
except command names, which are fully capitalized and 

ny^i ici laicu yVi ici icvci nicy ap^cai in icai, dmu CAwcpL ivi 

minor variations within command description boxes to help 
you differentiate between parameter types and parameter 
names. 
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For example: 

• Whenever the int parameter type is referred to in text, it 
is italicized, except when it specifies a parameter type in 
a command description. 

• If a paragraph mentions the EOL-string syntactic con- 
struct, or any other multiword construct that is not a 
command name, the reference is italicized and 
hyphenated. 

• If the BEGIN-FILL-PATTERN or COPY command is men- 
tioned, the command name is capitalized and hyphen- 
ated if it is multiword. 

• If the Jill-pattern-number parameter of the BEGIN-FILL- 
PATTERN command is referred to it is italicized and 
hyphenated. 

The colon (:) expresses the meaning of parameters, 
especially in the more complicated syntax definitions. For 
instance, the SET-BAUD-RATES command syntax is: 

E cNR \n\:transmlt-rate \n\:recelve-rate 

The expressions transmit-rate and receive-rate tell the 
meanings of the int parameters. 

When this manual represents the syntax of a syntactic con- 
struct, the equal sign ( = ) means "has the following syntax." 
For example: 

char-array = int [char...] 



In syntax definitions, a set of curly braces (( J) around a 
stacked list of parameters or construct elements means 
"choose one." For example, the SET-ALPHATEXT-FONT 
command syntax is: 



Col 



To use this command choose either s i or s o as the second 
character. 

In syntax definitions, parameters or construct elements that 
are enclosed in square brackets ([ ]) are optional. None, 
some, or all items enclosed may be included in the ASCII 
string sent to the terminal. For example: 

int = \HiI\HiI\HiI\HiI\HiI\\)\}LoI 

You could express this in words as, "An int consists of zero 
to five Hils, followed by a Lol." 

Syntactic constructs that may be repeated any number of 
times are followed by three dots. For example: 

string = int [char...] 

This could be expressed in words as, "A string consists of 
an int, followed by zero or more chars." 
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TEK COMMAND SYNTAX 

All commands to the terminal are sent from the host com- 
puter as a sequence of ASCII characters. A few of these 
commands consist of a single character; some consist of 
two characters; most consist of three or more characters. 



One-Character Commands 

The following commands consist of only one ASCII 
character: 

ENTER-ALPHA-MODE = u s 

ENTER-VECTOR-MODE = G s 

ENTER-MARKER-MODE = F s 

The ASCII control characters c r, 4, B s ; H x and v t are also 
one-character commands. In Alpha mode, each printable 
character that the terminal receives is a command to print 
that character. 

Two-Character Commands 

Most commands consist of escape sequences — 
sequences of ASCII characters beginning with the ^ char- 
acter. A few of these commands consist of only two 
characters: 

ENABLE-4010-GIN = ^b 

ENTER-ALPHA-MODE = ^"s 

ENTER-BYPASS-MODE = E tP» 

ENTER-VECTOR-MODE = 6 c G s 

ENTER-MARKER-MODE = E c F s 

PAGE = e c f f 

REPORT-4010-STATUS = e c e q 

SET-ALPHATEXT-FONT = E c s ior E c s o 

SET-4014-LINE-STYLE = E c chax.line-style 

4010-HARD-COPY = e c e b 



Commands of Three or More Characters 

Most of the terminal commands are escape sequences of 
three or more characters. These commands take the follow- 
ing format: 

1 . The first character is E c. This serves as a flag to tell the 
terminal that the following characters make up a 
command. 

2. The next two characters to identify the command. 

3. Parameters, if any, follow. The nine parameter types 
are described later in this section and in Section 7. 

4. Finally, terminate the command. You can do this in two 
ways: send all the command's parameters, or send one 
of the command terminator characters. Command 
terminator characters are: 

• £ c. The E c character that begins a new command 
aiso terminates the previous command. 

• u s, G s, and F s. Any command in progress ends when 
the terminal receives a u s, G s, or F s character. These 
characters are the single-character commands that 
put the terminal in Alpha mode, Vector mode, and 
Marker mode, respectively. 

When the terminal receives the parameter for a command, it 
ignores any control characters except the command termi- 
nators ( E c, u s, G s, and F s). Thus you can insert °b characters 
or other interline characters within the command's parame- 
ters with no ill effect. (This is useful if the parameter is a very 
long string or int-array.) 
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Defaults for Missing Parameters 

When you terminate a command early, the terminal assigns 
default values to the missing parameters. The standard 
defaults are: 

• for int parameters 

• 0.0 for real parameters 

• (0,0) for xy parameters 

• n l for char parameters 

• An array of elements for array parameters 

As you can see, the terminal assigns n l as the default for 

miccinn ^ft/rf nflramotprc Thic ic an ov^ontinn to ♦"*> rule* 

that char parameters must represent characters in the 
range from s p to " (ADEs 32 to 126)! See the discussion of 
the char parameter in this section and in Section 7 for more 
details. 

When an array parameter is terminated after being partially 
sent, the array count is adjusted to the number of elements 
already received. 

NOTE 

The terminal does not assign the standard defaults 
to some commands. To determine the default value 
for a particular command, consult the description 
of that command in Section 7. 



PARAMETER TYPES 

Parameters for escape sequence commands may be varia- 
bles of several different parameter types. Each parameter 
type has its own syntax and coding scheme. The parameter 
types are int, int-array, real, char, char-array ox string, 
device, xy, and xy-array. 



Int Parameters 

Integer numbers are sent to the terminal as int parameters. 
Int parameters represent integers ranging from -32768 to 
65535 on terminals that are not 41 15's, and 2 31 to -2 31 -1 on 
41 1 5 terminals. The int syntax is: 



int = [HiI[HiI[HiI[HiI[HiI\]}}\LoI 

where 

Hil = an ASCII character ranging from @ to d t (ADEs 64 
to 1 27), except that you can use the character 
sequence E c? instead of d t. 

Lol = an ASCII character ranging from s p to ? (ADEs 32 
through 63). 

You can find an algorithm for the int packing scheme in the 
discussion of the int parameter type in Section 7. 

Table 2-2 lists several examples of int parameters. For a 
more complete list, see Appendix B. 
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Table 2-2 
EXAMPLES OF INT PARAMETERS 



Number 


Int Parameter 








1 


1 


2 


2 


3 


3 


4 


4 


5 


5 


6 


6 


7 


7 


8 


8 


9 


9 


10 


: 


11 


) 


15 


? 


16 


A0 


17 


Ai 


-1 


i 


-2 


tt 


-15 


•> 


-16 


A s p 


-17 


A! 


1023 


D T?or E c?? 


1024 


A@0 


1025 


A@1 


-1024 


A@ S P 


-1025 


A@! 



Int-Array Parameters 

Some commands take int-array parameters. Int-array 
parameters consist of sequences of int parameters. The 
first int tells how many items are in the array; subsequent 
ints represent individual array items. 

For example, you would send the array of integers (1,5,-1, 
1 6) to the terminal as follows: 

int-array: (1 ,5,-1 ,16) = int:4 ( the count of 4 ) 

int:1 int:5int:-1 int:16 

= 415IA0 

You can find further information on int parameters in Sec- 
tion 7. 



Real Parameters 

Real numbers from -32767.0 to + 32767.0 can be sent to 
the terminal as real parameters. Real parameters consist of 
a pair of ints. The first int represents a number; the second 
int represents the power of two by which that number is to 
be multiplied. 

For instance, call the first int, X, the second int, Y, and the 
real number that you want to send, Z. In this case, 

Z = X -2 Y 



For example, you can represent the number 3.25 as 13 
multiplied by two raised to the power -2: 

real:3.25 = int:13int:-2 



You can find further information about real parameters in 
Section 7. 
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Char Parameters 

The char parameter type represents displayable ASCII 
characters. Each char parameter is a single ASCII character 
in the range from s p to " . (ASCII Decimal Equivalents from 
32 to 1 26.) Send char parameters to the terminal as the 
exact character you want to represent. You can find further 
information on the char parameter type in Section 7. 



String or Char-Array Parameters 

Strings, or arrays of displayable ASCII characters, are sent 
to the terminal as char-array parameters. Each such param- 
eter consists of an int telling how many items are in the 
array, followed by one char for each array item. 

For example, you would send the string "RAS" to the termi- 
nal as follows: 

string: "RAS" = int:3( the count of 3) 

RAS 

= 3RAS 

You can find more information on the string and char-array 
parameter types in Section 7. 



Device Parameters 

The device parameter type is essentially a subset of the 
string parameter type. Device parameters are used in data 
transfer commands such as COPY and SPOOL, and to 
inquire the status of devices with the REPORT-DEVICE- 
STATUS command. 



The device parameter type includes device-names, device- 
name filenames, device-name parameters and filenames. 

A device-name consists of three characters. The first two 
characters must be alphanumeric, and the last character 
must be a colon (:). 

A filename consists of two parts, the name and the exten- 
sion. The name can be from one to eight characters long, 
and the extension can be from zero to three characters 
long. If you include the extension, separate it from the name 
with a period (.). All ASCII characters except s p, *,.,:, ;, <, 

= .>,?, „ I, ], and . Control characters are ignored when 

they are received from the host, but are not valid when 
entered in Setup mode. If extra valid characters are added 
to the name or the extension, they are ignored. 

Some devices have parameters. These parameters specify 
special action for the device. They must be alphanumeric. 

The device parameter type has been separated from the 
string parameter type for convenience. The syntax of the 
device parameter type is the same as that of the string 
parameter type. 

For example, you wouid send the string "F0:FILE1 " to the 
terminal as follows: 

string: "F0:FILE1" = inf.8 ( the count of 8 ) 
F0:FILE1 
= 8F0:FILE1 

You can find more information on the device parameter type 
in Section 7. 
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XY Parameters 



Report Parameter Types 



The xy parameter type represents an (x,y) coordinate pair 
encoded for transmission to the terminal. Send xy parame- 
ters as a group of one to five ASCII characters. The range of 
x- and y-coordinates in an xy parameter depends on the 
terminal you are using; that is, the 4115 allows two coordi- 
nate modes, and other terminals allow only one. For more 
details, see the xy parameter description in Section 7. 



The parameter types described so far are for sending com- 
mand parameters to the terminal. When the terminal sends 
messages back to the host computer, it packs the informa- 
tion in a different format. Thus, for each host-to-terminal 
parameter type there is a corresponding terminal-to-host 
parameter type. Table 2-3 lists the types. 



XY-Array Parameters 

An xy-array parameter is a list of xy parameters preceded 
by an int telling how manyxys are in the array: 



xy-array 

For example: 

xy-array: 



= int[xy...\ 



(100,100) (200,200) (300,300) (400,400) 
= int:4 (the count of 4) 

xy:100,100 xy:200,200 xy:300,300 

xy:400,400 



You can find more information on packing the int and xy 
parameters in Section 7. 



Table 2-3 

HOST-TO-TERMINAL AND TERMINAL-TO-HOST 
PARAMETER TYPES 



Data To 
Be Sent 


Host-To-Terminal 
Parameter Type 


Terminal-To-Host 
Message Type 


Integer 
-2 31 to2 31 -1 


int 


int-report or intc-report 
(4115) 


Array of 
integers 


int-array 


int-array-report 


Real (-32767.0 
to +32767.0) 


real 


real-report 


Displayabie 
Character 


char 


char-report 


String of 
Characters 


string and char-array 


string-report 


Spatial 
Coordinates 


xy or int int (411 5) 


xy-report or intc-report 
intc-report (41 15) 



For more information on int-reports, intc-reports int-array- 
reports, real-reports, char-reports, string-reports, andxy- 
reports, see those descriptions in Section 7. 
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ANSI COMMAND SYNTAX 

The ANSI X3.64 commands that are in Section 8 use a 
different syntax than the TEK commands in Section 7. 
These commands are only valid on 41 1 2, 41 1 3, and 4115 
terminals (not 41 14 or 41 16 terminals), and only in the dia- 
log areas of these terminals (not in the graphics area). ANSI 
commands (including alphatext) affect only the dialog area, 
whether the dialog area is enabled or not. 

There are two syntax forms for the ANSI commands. Com- 
mands of one of these syntax forms consist of an ^ charac- 
ter and a unique final character. The final character is what 
identifies each command. The commands with this syntax 



Commands of the other syntax form consist of a control- 
sequence-introducer (CSI), zero or more parameters of 
either Pn or Ps types, and a unique final character. The CSI 
and the terminator together identify individual commands. 

The CSI syntax is: 
E c[ 

Substitute these two characters whenever the CSI is called 
for. 

The symbols that are used to represent syntax elements 
and conventions for ANSI commands are the same as those 
used for TEK commands (see Table 2-1 ). 



ANSI PARAMETER TYPES 

There are two parameter types for ANSI X3.64 commands, 
Pn and Ps. 



Pn 



Pn is a numeric parameter ranging from to 32767. Send 
Pn's as a sequence of digits. For example, send the number 
75 as the two characters 7 and 5. There is no special pack- 
ing scheme for this parameter type. If the Pn is or missing 
it is interpreted as 1 unless it is part of a Ps parameter. 



Ps 



Ps is a parameter selected from a given list. When the 
parameter type is Ps, the command description gives you a 
choice of parameters. There is no special packing scheme 
for this parameter type. They all have the format of a Pn or 
(char)P« where (char) is <,:,>, or ?. 

The semicolon (;) separates parameters in a command 
string. Enter a semicolon between parameters when you 
are entering more than one parameter for a command. You 
can enter up to 46 characters of Ps parameters for a com- 
mand that expects Ps parameters. 



COMMAND TERMINATORS 

ANSI mode uses the c n and s b characters as command 
terminators. When these characters are received in the 
middle of a command, the command is terminated and any 
characters belonging to that command that have already 
been received are discarded. When this occurs, a snoopy 
character c n or s b will appear on the terminal screen. 
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iNDEX OF COMMANDS BY FUNCTION 



GENERAL TERMINAL CONTROL Page 

CANCEL = E cKC 7-35 

IGNORE-DELETES = E cKI int 7-122 

RESET = E cKV 7-179 

SET-EDIT-CHARS = E cKZ int int int 7-244 



KEYBOARD CONTROL 
AND MACRO DEFINITIONS 

DEFINE-MACRO = ^KD int int-array 7-48 

EXPAND-MACRO = E cKX int 7-103 

SET-KEY-EXECUTE-CHARACTER = E cKY int 7-280 

LOCK-KEYBOARD = E cKL int 7-133 

LOCK-VIEWING-KEYS = ^RJ int 7-134 

CONTROLLING THE DISPLAY 

ENABLE-DIALOG-AREA = E cKA int 7-76 

CRLF = E cKR int 7-47 

SET-ECHO = E cKE int 7-243 

HARDCOPY = E cKH int 7-118 

4010-HARDCOPY = e c e b 7-399 

LFCR = E cKF int 7-130 

SET-MARGINS = ^KM int 7-284 

PAGE = e c f f 7-140 

RENEW-VIEW = E cKN int 7-167 

SET-GRAPH!CS-AREA-WR!T!NG-MODE 

= EcMG int 7-269 

SET-PAGE-FULL-ACTION = ^KP int 7-291 

SET-SNOOPY-MODE = E cKS int 7-344 

SET-FIXUP-LEVEL = E cRF int 7-251 

SET-ERROR-THRESHOLD = ^KT int 7-250 



DIALOG AREA 



Page 



CLEAR-DIALOG-SCROLL = E cLZ 7-40 

ENABLE-DIALOG-AREA = ^KA int 7-76 

SET-DIALOG-AREA-ALTERNATE-INDEX 

= E cLJ int 7-229 

SET-DIALOG-AREA-BUFFER-SIZE = E cLB int 7-230 

SET-DIALOG-AREA-CHARS = E cLC int 7-231 

SET-DIALOG-AREA-INDEX = E cLl int int int 7-232 

SET-DIALOG-AREA-LINES = E cLL int 7-234 

SET-DIALOG-AREA-POSITION = E cLX xy 7-235 

SET-DIALOG-AREA-SURFACE = E cLS int 7-236 

SET-DIALOG-AREA-VISIBILITY = E cLVint 7-237 

SET-DIALOG-AREA-WRITING-MODE = E cLM int. . . . 7-239 



HOST PORT COMMUNICATIONS 

COPY = E cJC device string device 7-43 

ENTER-BYPASS-MODE = e c c n 7-94 

IGNORE-DELETES = E cKI int 7-122 

PROMPT-MODE = E cNM int 7-153 

SET-BAUD-RATES = E cNR int int 7-206 

SET-BREAK-TIME = ^NKint 7-221 

SET-BYPASS-CANCEL-CHAR = E cNU int 7-222 

SET-EOF-STRING = E cNE int-array 7-246 

SET-EOL-STRING = E cNT int-array 7-248 

SET-EOM-CHARS = e cNC int int 7-249 

SET-FLAGGING-MODE = E cNF int 7-253 

SET-PARITY = E cNP int 7-298 

SET-PROMPT-STRING = E cNS int-array 7-318 

SET-QUEUE-SIZE = ^NQ int 7-319 

SET-REPORT-MAX-LINE-LENGTH = E clL int 7-323 

SET-STOP-BITS = E cNB int 7-345 

SET-TRANSMIT-DELAY = E cND int 7-361 

SET-TRANSMIT-RATE-LIMIT = E cNL int 7-362 
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MODE SWITCHING 



Page 



ENTER-ALPHA-MODE = °s 7-92 

ENTER-MARKER-MODE = F s 7-96 

ENTER-VECTOR-MODE = Gs 7-97 

SELECT-CODE = E c%! int 7-191 

SET-COORDINATE-MODE = E cUX int 7-226 



GRAPHIC PRIMITIVES 

AND PRIMITIVE ATTRIBUTES 

Lines 

ENTER-VECTOR-MODE = G s 7-97 

IWiO V i_ — K/L.I Xy / - I O/ 

DRAW = E cLGxy 7-72 

SET-LINE-INDEX = E cML int 7-281 

SET-LINE-STYLE = E cMV int 7-282 

SET-4014-LINE-STYLE = E c char 7-373 

SET-LINE-WIDTH = E cMW int 7-283 

Markers 

ENTER-MARKER-MODE = F s 7-96 

DRAW-MARKER = E cLH xy 7-73 

SET-MARKER-TYPE = ^MM int 7-286 

Graphtext 

GRAPHIC-TEXT = ^LT string 7-116 

SET-GRAPHTEXT-FONT = E cMF int 7-270 

SET-GRAPHTEXT-FONT-GRID = ^SG int int int ... . 7-272 

SET-GRAPHTEXT-PRECISION = E cMQ int 7-274 

SET-GRAPHTEXT-ROTATION = E cMR real 7-275 

SET-GRAPHTEXT-SIZE = E cMC int int int 7-276 

SET-GRAPHTEXT-SLANT = E cMA real 7-277 

SET-TEXT-INDEX = E cMT int 7-360 

Alphatext 

ENTER-ALPHA-MODE = u s 7-92 

SELECT-ALPHATEXT-SIZE-GROUP = E cMY int 7-189 

SET-ALPHATEXT-FONT = E c s i or E c s o 7-1 98 

SET-ALPHATEXT-SIZE = E cMZ int int int 7-199 

SET-4014-ALPHATEXT-SIZE 

= E c8, E c9, E c;, or E c: 7-372 

SET-TEXT-INDEX = E cMT int 7-360 



Panels (4112, 4113, 4115) Page 

BEGIN-PANEL-BOUNDARY = E cLPxyint 7-16 

DRAW-RECTANGLE = E cUR xy-array 7-74 

END-PANEL = E cLE 7-90 

SELECT-FILL-PATTERN = E cMP int 7-192 

SET-DRAW-BOUNDARY-MODE = E cUB int 7-241 

SET-PANEL-FILLING-MODE = E cMS int int int 7-293 

Other Graphic Primitives 

INCLUDE-COPY-OF-SEGMENT = E cLK int 7-123 

SET-PICK-ID = E cMI int 7-300 

SET-GRAPHICS-AREA-WRITING-MODE = E cMG int 7-269 



PmNcuS(4i i^, 4(13, 4i ia) 

Drawing Panels 

BEGIN-PANEL-BOUNDARY = E cLPxy int 7-16 

DRAW-RECTANGLE = E cUR xy-array 7-74 

END-PANEL = E cLE 7-90 

SELECT-FILL-PATTERN = E cMP int 7-192 

SET-DRAW-BOUNDARY-MODE = E cUB int 7-241 

SET-PANEL-FILLING-MODE = E cMS int int int 7-293 

Defining Fill Patterns for Panels 

BEGIN-FILL-PATTERN = E cMD int int int int 7-8 

END-FILL-PATTERN = E cME 7-88 



GRAPHTEXT 

Displaying Graphtext 

GRAPHIC-TEXT = E cLT string 7-116 

SET-GRAPHTEXT-FONT = E cMF int 7-270 

SET-GRAPHTEXT-PRECISION = E cMQ int 7-274 

SET-GRAPHTEXT-ROTATION = E cMR real 7-275 

SET-GRAPHTEXT-SIZE = E cMC int int int 7-276 

SET-GRAPHTEXT-SLANT = E cMA real 7-277 

Defining Graphtext Characters 

BEGIN-GRAPHTEXT-CHARACTER = E cST int int . . . 7-10 
DELETE-GRAPHTEXT-CHARACTER = E cSZ int int . 7-53 

END-GRAPHTEXT-CHARACTER = E cSU 7-89 

SET-GRAPHTEXT-FONT-GRID = E cSG int int int ... . 7-272 
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SEGMENTS 

Defining Segments Page 

BEGIN-HIGHER-SEGMENT = E cSN 7-12 

BEGIN-LOWER-SEGMENT = E cSB 7-13 

BEGIN-NEW-SEGMENT = ^SE int 7-14 

BEGIN-SEGMENT = ^SO int 7-23 

DELETE-SEGMENT = E cSK int 7-55 

END-SEGMENT = ^SC 7-91 

INCLUDE-COPY-OF-SEGMENT = E cLK int 7-123 

RENAME-SEGMENT = E cSR int int 7-166 

SET-PiVOT-POiNT = ^SP xy 7-302 

Setting Segment Attributes 

SET-SEGMENT-CLASS 

= E cSA int int-array int-array 7-327 

SET-SEGMENT-DETECTABILITY = E cSD int int 7-329 

SET-SEGMENT-DISPLAY-PRIORITY 

= E cSS int int 7-331 

SET-SEGMENT-HIGHLIGHTING = E cSH int int 7-332 

SET-SEGMENT-IMAGE-TRANSFORM 

= E cSI int real real real xy 7-334 

SET-SEGMENT-POSITION = E cSX int xy 7-337 

SET-SEGMENT-VISIBILITY = E cSV int 7-339 

SET-SEGMENT-WRITING-MODE = ^SM int int 7-341 

Segment Classes 

SET-CURRENT-MATCHING-CLASS 

= E cSL int-array int-array 7-228 

SET-SEGMENT-CLASS 

= E cSA int int-array int-array 7-327 

Reporting Segment Settings to the Host 

REPORT-SEGMENT-STATUS 

= E cSQ int char-array 7-1 74 

Displaying Segments (411 2, 41 1 3, 411 5) 

SET-FIXUP-LEVEL = E cRF int 7-251 

Saving Segments 

SAVE = E cJV string int string device 7-1 83 

GIN (GRAPHIC INPUT) 

Enabling and Disabling GIN 

ENABLE-GIN = ^lE int int 7-79 

ENABLE-4010-GIN = e c s b 7-83 

ENABLE-4953-TABLET-GIN = E ci! char 7-85 

DISABLE-GIN = E clD int 7-69 

DISABLE-4953-TABLET-GIN = E cl! char 7-70 

REPORT-GIN-POINT = ^IPint 7-171 



Setting GIN Parameters Page 

SET-GIN-AREA = E ciV int int xy xy 7-255 

SET-GIN-CURSOR = E clC int int 7-257 

SET-GIN-DISPLAY-START-POINT = E clX intxy 7-259 

SET-GIN-GRIDDING = ^IG int int int 7-260 

SET-GIN-iNKING = ^11 int int 7-262 

SET-GIN-RUBBERBANDING = E clR int int 7-264 

SET-GIN-STROKE-FILTERING = E clF int int int 7-266 

SET-GIN-WINDOW = E clWxy xy 7-268 

SET-PICK-APERTURE = E clA int 7-299 

Setting Parameters for GIN Reports 

SET-REPORT-EOM-FREQUENCY = E clM int 7-321 

SET-REPORT-MAX-LINE-LENGTH = E clL int 7-323 

SET-REPORT-SIG-CHARS = E clS int int int 7-325 
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Requesting Non-GiN Reports 

REPORT-COLORHARDCOPY-STATUS = E cQQ 7-168 

REPORT-DEVICE-STATUS = E cJQ device 7-169 

REPORT-ERRORS = ^KQ 7-170 

REPORT-PORT-STATUS = E cPQ device 7-173 

REPORT-SEGMENT-STATUS 

= E cSQ int char-array 7-174 

REPORT-TERMINAL-SETTINGS 

= E clQ char char 7-1 76 

REPORT-4010-STATUS = E c E o 7-178 

Setting Parameters for Non-GIN Reports 

SET-REPORT-EOM-FREQUENCY = E clM int 7-321 

SET-REPORT-MAX-LINE-LENGTH = E c!L int 7-323 

SET-REPORT-SIG-CHARS = E clS int int int 7-325 



SURFACES (4112,4113,4115) 

SET-BACKGROUND-COLOR = E cTB int int int 7-201 

SET-BACKGROUND-GRAY-LEVEL = E cRB int 7-203 

SET-BACKGROUND-INDICES = E cMB int int 7-204 

SET-DIALOG-AREA-SURFACE = E cLS int 7-236 

SET-SURFACE-DEFINITIONS = E cRD int-array 7-349 

SET-SURFACE-COLOR-MAP = E cTG int int-array . . . 7-346 
SET-SURFACE-GRAY-LEVELS 

= E cRG int int-array 7-351 

SET-SURFACE-PRIORITIES = ^RN int-array 7-354 

SET-SURFACE-VISIBILITY = E cRI int-array 7-356 
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MULTIPLE VIEWS 

Defining and Selecting Views Page 

DELETE-VIEW = ^RK int 7-57 

SELECT-VIEW = ^RCint 7-196 

RENEW-VIEW = EcKN int 7-167 

SET-OVERVIEW-WINDOW = E cUWxyxy 7-289 

SET-VIEW-ATTRIBUTES = EcRA int int int 7-364 

SET-VIEW-DISPLAY-CLUSTER = E cRQ int-array .... 7-366 

SET-VIEWPORT = EcRVxyxy 7-368 

SET-WINDOW = E cRWxyxy 7-370 

ZOOM and PAN Operations 

LOCK-VIEWING-KEYS = E cRJ int 7-134 

SET-OVERVIEW-WINDOW = ^UWxy xy 7-289 

SET-WINDOW = E cRWxy xy 7-370 

Controlling a Viewports Border 

SET-BORDER-VISIBILITY = ^RE int 7-220 



INK COLORS (41 12, 41 13, 41 15) 

SET-BACKGROUND-COLOR = EcTB int int int 7-201 

SET-BACKGROUND-GRAY-LEVEL = E cRB int 7-203 

SET-BACKGROUND-INDICES = E cMB int int 7-204 

SET-COLOR-MODE = E cTM int int int 7-224 

SET-LINE-INDEX = EcML int 7-281 

SET-TEXT-INDEX = E cMT int 7-360 

SET-SURFACE-COLOR-MAP = E cTG int int-array . . . 7-346 
SET-SURFACE-GRAY-LEVELS = ^RG int int-array .. 7-351 



PIXEL OPERATIONS 

Initialization 

BEGIN-PIXEL-OPERATIONS = ^RU int int int 7-20 

SET-PIXEL-VIEWPORT = E cRS xy xy 7-304 

SET-PIXEL-BEAM-POSITION = E cRH xy 7-303 

SET-PIXEL-WRITING-FACTORS = E cRT int int int . . . 7-306 

Data Transfer 

PIXEL-COPY = E cRXintxyxy xy 7-143 

RASTER-WRITE = E cRP int char-array 7-155 

RUNLENGTH-WRITE = E cRL int-array 7-181 

RECTANGLE-FILL = E cRR xy xy int 7-1 63 

SAVE = E cJV string int string device 7-1 83 



OPTION 01 

(HALF-DUPLEX AND BLOCK MODE) 

Half-Duplex Mode Page 

SET-DUPLEX-MODE = E cOD int 7-242 

Block Mode 

ARM-FOR-BLOCK-MODE = E cOB int 7-4 

SET-BLOCK-CONTINUE-CHARS = E cOC int int 7-208 

SET-BLOCK-END-CHARS = E cOE int int 7-209 

SET-BLOCK-HEADERS = E cOH int-array int-array. . . 7-210 

SET-BLOCK-LENGTH = E cOS int int 7-212 

SET-BLOCK-LINE-LENGTH = E cOL int 7-213 

SET-BLOCK-MASTER-CHARS - E cOM int int 7 214 

SET-BLOCK-NON-XMT-CHARS 

= E cON int-array int-array 7-215 

SET-BLOCK-PACKING = E cOP int int int int 7-217 

SET-BLOCK-TIMEOUT = E cOT int 7-219 

PERIPHERAL DEVICES 

Standard 41 10 Series Peripheral Support 

COPY = E cJC device string device 7-43 

LOAD = E cJL device 7-131 

REPORT-DEVICE-STATUS = E cJQ device 7-169 

SPOOL = E cJS device string device 7-376 

STOP-SPOOLING = E cJE 7-380 

Option 3A (DMA Interface) 

SET-DMA-BLOCK-SIZE = E cJH int 7-240 

Option 09 (Color Hardcopy Interface) 

REPORT-COLORHARDCOPY-STATUS = E cQQ 7-168 

SELECT-HARDCOPY-INTERFACE = E cQD int 7-195 

SET-COLOR-COPIER-DATA-RESOLUTION 

= E cQB int 7-223 

SET-IMAGE-ORIENTATION = E cQO int 7-278 

SET-NUMBER-OF-COPIES = E cQN int 7-288 
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Option 1 (Three Port Peripheral Interface) Page 

MAP-INDEX-TO-PEN = ^Pl device intint 7-135 

PLOT = E cPL string device 7-145 

PORT-ASSIGN = E cPA device string int 7-147 

PORT-COPY = E cPC device string device 7-149 

REPORT-PORT-STATUS = E cPQ device 7-173 

SET-PORT-BAUD-RATE = E cPR device int 7-308 

SET-PORT-EOF-STRING = E cPE device int-array. . . . 7-309 
SET-PORT-EOL-STRING = ^PM device int-array . . . 7-31 1 
SET-PORT-FLAGGING-MODE 

= E cPF device int int int 7-312 

SET-PORT-PARITY = E cPP device int 7-314 

SET-PORT-STOP-BITS = E cPB device int int 7-316 

Options 13 and 14 (Graphics Tablet) 

ENABLE-GIN = E clE int int 7-79 

ENABLE-4953-TABLET-GIN = E cl! char 7-85 

DISABLE-GIN = E clD int 7-69 

DISABLE-4953-TABLET-GIN = E cl! char 7-70 

SET-GIN-STROKE-FILTERING = ^IF int int int 7-266 

SET-TABLET-HEADER-CHARACTERS = ^IH int. . . . 7-357 

SET-TABLET-SIZE = E clN int 7-358 

SET-TABLET-STATUS-STRAP = E clT int 7-359 

Options 42, 43, and 45 (Disk Drive Options) 

ACTIVATE-LPOS = E cJB 7-2 

COPY = E cJC device string device 7-43 

DELETE-FILE = ^JK device 7-52 

DIRECTORY = E cJD device string device 7-67 

DISMOUNT = E cJJ device 7-71 

FORMAT-VOLUME = E cJF device 7-106 

LOAD = E cJL device 7-131 

rri^j i cu i-rii_C = Cur ucviuc nil /- iDt 

RENAME-FILE = E cJR device string device 7-164 

REPORT-DEVICE-STATUS = E cJQ device 7-169 

SAVE = E cJV string int string device 7-1 83 

SET-USER-NUMBER = E cJU int 7-363 

SPOOL = ^JS device string device 7-376 

STOP-SPOOLING = ^JE 7-380 



ANSI COMMANDS 

Cursor Commands Page 

CURSOR-BACKWARD = CS/Pn D 8-4 

CURSOR-BACKWARD-TAB = CS/Pn Z 8-5 

CURSOR-DOWN = CS/Pn B 8-5 

CURSOR-FORWARD = CS/Pn C 8-6 

CURSOR-HORIZONTAL-TAB = CS/Pn I 8-6 

CURSOR-POSITION = CS/Pn Pn H 8-7 

CURSOR-UP = CS/Pn A 8-8 

DEVICE-STATUS-REPORT = CS/Ps n 8-10 

HORIZONTAL-AND-VERTICAL-POSITION 

= CS/Pn Pnf 8-13 

INDEX = E cD 8-15 

NEXT-LINE = ^E 8-16 

RESTORE-CURSOR = E c8 8-18 

REVERSE-INDEX = E cM 8-19 

SAVE-CURSOR = E c7 8-19 

Tab Commands 

CURSOR-BACKWARD-TAB = CS/Pn Z 8-5 

CURSOR-HORIZONTAL-TAB = CS/Pn I 8-6 

HORIZONTAL-TAB-SET = E cH 8-14 

TABULATION-CLEAR = CS/Ps g 8-25 

Changing Modes and Graphic Renditions 

DISABLE-MANUAL-INPUT = E c' 8-10 

ENABLE-MANUAL-INPUT = E cb 8-11 

RESET-MODE = CS/Ps Ps ... 1 8-17 

RESET-TO-INITIAL-STATE = E cc 8-18 

SELECT-CODE = E c%! int 7-191, 

8-22 

SELECT-GRAPHiC-RENDITION = CS/Ps Ps 8-23 

SET-MODE = CS/Ps Ps 8-24 

Inserting and Deleting Lines 

DELETE-LINE = CS/Pn M 8-9 

ERASE-IN-DISPLAY = CS/Ps J 8-12 

INSERT-LINE = CS/Pn L 8-16 

Inserting and Deleting Characters 

DELETE-CHARACTER = CS/Pn P 8-9 

ERASE-CHARACTER = CS/PnX 8-11 

ERASE-IN-LINE = CS/PS K 8-12 

INSERT-CHARACTER = CS/Pn @ 8-15 

Scrolling the Scroll Buffer 

[T SCROLL-DOWN = CS/Pn T 8-20 

[S SCROLL-UP = CS/Pn S 8-21 
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INDEX OF SYNTACTIC CONSTRUCTS BY TYPE 



CHARACTERS 



MESSAGE TYPES (cont) 



Name Page 

b l Character 7-26 

B s Character 7-33 

"n \jiiaitMjitsi o-o 

c r Character 7-46 

d t Character 7-50 

*c Character 7-102 

F FCharacter 8-13 

h t Character 7-121, 

8-14 

l f Character 7-129 

s b Character 8-20 

s i Character 7-375 

s o Character 7-375 

u s Character 7-388 

v t Character 7-390, 

8-25 



PARAMETER TYPES 

Array Parameter Types 7-6 

Char Parameter Type 7-37 

Device Parameter Type 7-59 

Int Parameter Type 7-124 

Real Parameter Type 7-160 

String Parameter Type 7-381 

XY Parameter Type 7-391 

MESSAGE TYPES 

Array-Report Message Types 7-7 

Char-Report Message Type 7-38 

Colorhardcopy-Status-Report Message Type 7-41 

Device-Status-Report Message Type 7-63, 8-10 

Error-Report Message Type 7-101 

GIN-Report-Sequence Message Type 7-111 

Int-Report Message Type 7-127 

Intc-Report Message Type 7-128 

Int-Array-Report Message Type 7-129 

Port-Status-Report Message Type 7-151 

Real-Report Message Type 7-162 

Segment-Status-Report Message Type 7-186 



Name Page 

String-Report Message Type 7-382 

Terminal-Settings-Report Message Type 7-383 

XY-Report Message Type 7-394 

4010-Status-Report Message Type 7-400 

KEYS 

BORDER Key 7-31 

BREAK Key 7-32 

CANCEL Key , . 7-36 

CLEAR Key 7-39 

DIALOG Key 7-66 

HARD COPY Key 7-120 

NEXTVIEW Key 7-138 

NORMAL Key 7-138 

OVERVIEW Key 7-139 

PAGE Key 7-141 

PAN Key 7-141 

RESTORE Key 7-180 

SETUP Key 7-374 

VIEW Key 7-389 

ZOOM Key 7-396 

SYNTACTIC CONSTRUCTS 

Block Syntactic Construct 7-27 

Block-Control-Bytes Syntactic Construct 7-29 

Bypass-Cancel-Char 7-34 

Delete-Equivalent Syntactic Construct 7-51 

EOF-String Syntactic Construct 7-98 

EOL-String Syntactic Construct 7-99 

EOM-lndicator Syntactic Construct 7-1 00 

Fill-Pattern-Definition Syntactic Construct 7-105 

GIN-Locator-Report Syntactic Construct 7-1 08 

GIN-Pick-Report Syntactic Construct 7-109 

GIN-Stroke-Report Syntactic Construct 7-114 

Key-Execute-Character 7-129 

Panel-Definition Syntactic Construct 7-142 

4010-Gin-Report Syntactic Construct 7-397 

4953-Tablet-Gin-Report Syntactic Construct 7-402 
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INDEX OF COMMANDS BY ESCAPE SEQUENCE OP CODES 



TEK COMMANDS 



Op 

Code Command Name Page 

o/o! SELECT-CODE 7-191 

I! ENABLE-4953-TABLET-GIN 7-85 

DISABLE-4953-TABLET-GIN 7-70 

IA SET-PICK-APERTURE 7-299 

IC SET-GIN-CURSOR 7-257 

ID DISABLE-GIN 7-69 

IE ENABLE-GIN 7-79 

IF SET-GIN-STROKE-FILTERING 7-266 

IG SET-GIN-GRIDDING 7-260 

IH SET-TABLET-HEADER-CHARACTERS 7-357 

II SET-GIN-INKING 7-262 

IL SET-REPORT-MAX-LINE-LENGTH 7-323 

IM SET-REPORT-EOM-FREQUENCY 7-321 

IN SET-TABLET-SIZE 7-358 

IP REPORT-GIN-POINT 7-171 

IQ REPORT-TERMINAL-SETTINGS 7-1 76 

IR SET-GIN-RUBBERBANDING 7-264 

IS SET-REPORT-SIG-CHARS 7-325 

IT SET-TABLET-STATUS-STRAP 7-359 

IV SET-GIN-AREA 7-255 

IW SET-GIN-WINDOW 7-268 

IX SET-GIN-DISPLAY-START-POINT 7-259 

JB ACTIVATE-LPOS 7-2 

JC COPY 7-43 

JD DIRECTORY 7-67 

JE STOP-SPOOLING 7-380 

JF FORMAT-VOLUME 7-106 

JH SET-DMA-BLOCK-SIZE 7-240 

JJ DISMOUNT 7-71 

JK DELETE-FILE 7-52 

JL LOAD 7-131 

JP PROTECT-FILE 7-154 

JQ REPORT-DEVICE-STATUS 7-1 69 

JR RENAME-FILE 7-164 

JS SPOOL 7-376 

JU SET-USER-NUMBER 7-363 

JV SAVE 7-183 

KA ENABLE-DIALOG-AREA 7-76 

KC CANCEL 7-35 

KD DEFINE-MACRO 7-48 

KE SET-ECHO 7-243 



Op 

Code Command Name Page 

KF LFCR 7-130 

KH HARDCOPY 7-118 

KI IGNORE-DELETES 7-122 

i \i- t-\J\st vi \k. i D^/ni il^ r-i uu 

KM SET-MARGINS 7-284 

KN RENEW-VIEW 7-167 

KP SET-PAGE-FULL-ACTION 7-291 

KQ REPORT-ERRORS 7-170 

KR CRLF 7-47 

KS SET-SNOOPY-MODE 7-344 

KT SET-ERROR-THRESHOLD 7-250 

KV RESET 7-179 

KX EXPAND-MACRO 7-103 

KY SET-KEY-EXECUTE-CHARACTER 7-280 

KZ SET-EDIT-CHARS 7-244 

LB SET-DIALOG-AREA-BUFFER-SIZE 7-230 

LC SET-DIALOG-AREA-CHARS 7-231 

LE END-PANEL 7-90 

LF MOVE 7-137 

LG DRAW 7-72 

LH DRAW-MARKER 7-73 

LI SET-DIALOG-AREA-INDEX 7-232 

LJ SET-DIALOG-AREA-ALTERNATE-INDEX .... 7-229 

LK INCLUDE-COPY-OF-SEGMENT 7-1 23 

LL SET-DIALOG-AREA-LINES 7-234 

LM SET-DIALOG-AREA-WRITING-MODE 7-239 

LP BEGIN-PANEL-BOUNDARY 7-16 

LS SET-DIALOG-AREA-SURFACE 7-236 

LT GRAPHIC-TEXT 7-116 

LV SET-DIALOG-AREA-VISIBILITY 7-237 

LX SET-DIALOG-AREA-POSITION 7-235 

LZ CLEAR-DIALOG-SCROLL 7-40 

MA SET-GRAPHTEXT-SLANT 7-277 

MB SET-BACKGROUND-INDICES 7-204 

MC SET-GRAPHTEXT-SIZE 7-276 

MD BEGIN-FILL-PATTERN 7-8 

ME END-FILL-PATTERN 7-88 

MF SET-GRAPHTEXT-FONT 7-270 

MG SET-GRAPHICS-AREA-WRITING-MODE .... 7-269 

Ml SET-PICK-ID 7-300 

ML SET-LINE-INDEX 7-281 

MM SET-MARKER-TYPE 7-286 

MP SELECT-FILL-PATTERN 7-192 
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Op Op 

Code Command Name Page Code 

MQ SET-GRAPHTEXT-PRECISION 7-274 RB 

MR SET-GRAPHTEXT-ROTATION 7-275 RC 

MS SET-PANEL-FILLING-MODE 7-293 RD 

MT SET-TEXT-INDEX 7-360 RE 

MV SET-LINE-STYLE 7-282 RF 

MW SET-LINE-WIDTH 7-283 RG 

MY SELECT-ALPHATEXT-SIZE-GROUP 7-189 RH 

MZ SET-ALPHATEXT-SIZE 7-199 Rl 

NB SET-STOP-BITS 7-345 RJ 

NC SET-EOM-CHARS 7-249 RK 

ND SET-TRANSMIT-DELAY 7-361 RL 

NE SET-EOF-STRING 7-246 RN 

IMF SET-FLAGGING-MODE 7-253 RP 

NK SET-BREAK-TIME 7-221 RQ 

NL SET-TRANSMIT-RATE-LIMIT 7-362 RR 

NM PROMPT-MODE 7-153 RS 

NP SET-PARITY 7-298 RT 

NQ SET-QUEUE-SIZE 7-319 RU 

NR SET-BAUD-RATES 7-206 RV 

NS SET-PROMPT-STRING 7-318 RW 

NT SET-EOL-STRING 7-248 RX 

NU SET-BYPASS-CANCEL-CHAR 7-222 SA 

OB ARM-FOR-BLOCK-MODE 7-4 SB 

OC SET-BLOCK-CONTINUE-CHARS 7-208 SC 

OD SET-DUPLEX-MODE 7-242 SD 

OE SET-BLOCK-END-CHARS 7-209 SE 

OH SET-BLOCK-HEADERS 7-210 SG 

OL SET-BLOCK-LINE-LENGTH 7-213 SH 

OM SET-BLOCK-MASTER-CHARS 7-214 SI 

ON SET-BLOCK-NON-XMT-CHARS 7-21 5 SK 

OP SET-BLOCK-PACKING 7-217 SL 

OS SET-BLOCK-LENGTH 7-212 SM 

OT SET-BLOCK-TIMEOUT 7-219 SN 

PA PORT-ASSIGN 7-147 SO 

PB SET-PORT-STOP-BITS 7-316 SP 

PC PORT-COPY 7-149 SQ 

PE SET-PORT-EOF-STRING 7-309 SR 

PF SET-PORT-FLAGGING-MODE 7-312 SS 

PI MAP-INDEX-TO-PEN 7-135 ST 

PL PLOT 7-145 SU 

PM SET-PORT-EOL-STRING 7-31 1 SV 

PP SET-PORT-PARITY 7-314 SX 

PQ REPORT-PORT-STATUS 7-173 SZ 

PR SET-PORT-BAUD-RATE 7-308 TB 

QB SET-COLOR-COPIER-DATA-RESOLUTION . . 7-223 TG 

QD SELECT-HARDCOPY-INTERFACE 7-1 95 TM 

QN SET-NUMBER-OF-COPIES 7-288 UB 

QO SET-IMAGE-ORIENTATION 7-278 UR 

QQ REPORT-COLORHARDCOPY-STATUS 7-1 68 UW 

RA SET-VIEW-ATTRIBUTES 7-364 UX 



Command Name Page 

SET-BACKGROUND-GRAY-LEVEL 7-203 

SELECT-VIEW 7-196 

SET-SURFACE-DEFINITIONS 7-349 

SET-BORDER-VISIBILITY 7-220 

SET-FIXUP-LEVEL 7-251 

SET-SURFACE-GRAY-LEVELS 7-351 

SET-PIXEL-BEAM-POSITION 7-303 

SET-SURFACE-VISIBILITY 7-356 

LOCK-VIEWING-KEYS 7-134 

DELETE-VIEW 7-57 

RUNLENGTH-WRITE 7-181 

SET-SURFACE-PRIORITIES 7-354 

RASTER-WRITE 7-155 

SET-VIEW-DISPLAY-CLUSTER 7-366 

RECTANGLE-FILL 7-163 

SET-PIXEL-VIEWPORT 7-304 

SET-PIXEL-WRITING-FACTORS 7-306 

BEGIN-PIXEL-OPERATIONS 7-20 

SET-VIEWPORT 7-368 

SET-WINDOW 7-370 

PIXEL-COPY 7-143 

SET-SEGMENT-CLASS 7-327 

BEGIN-LOWER-SEGMENT 7-13 

END-SEGMENT 7-91 

SET-SEGMENT-DETECTABILITY 7-329 

BEGIN-NEW-SEGMENT 7-14 

SET-GRAPHTEXT-FONT-GRID 7-272 

SET-SEGMENT-HIGHLIGHTING 7-332 

SET-SEGMENT-IMAGE-TRANSFORM 7-334 

DELETE-SEGMENT 7-55 

SET-CURRENT-MATCHING-CLASS 7-228 

SET-SEGMENT-WRITING-MODE 7-341 

BEGIN-HIGHER-SEGMENT 7-12 

BEGIN-SEGMENT 7-23 

SET-PIVOT-POINT 7-302 

REPORT-SEGMENT-STATUS 7-174 

RENAME-SEGMENT 7-166 

SET-SEGMENT-DISPLAY-PRIORITY 7-331 

BEGIN-GRAPHTEXT-CHARACTER 7-10 

END-GRAPHTEXT-CHARACTER 7-89 

SET-SEGMENT-VISIBILITY 7-339 

SET-SEGMENT-POSITION 7-337 

DELETE-GRAPHTEXT-CHARACTER 7-53 

SET-BACKGROUND-COLOR 7-201 

SET-SURFACE-COLOR-MAP 7-346 

SET-COLOR-MODE 7-224 

SET-DRAW-BOUNDARY-MODE 7-241 

DRAW-RECTANGLE 7-74 

SET-OVERVIEW-WINDOW 7-289 

SET-COORDINATE-MODE 7-226 
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ANSI COMMANDS 

Op 

Code Command Name Page 

o/o! SELECT-CODE 8-22 

[@ INSERT-CHARACTER 8-15 

[A CURSOR-UP 8-8 

[B CURSOR-DOWN 8-5 

[C CURSOR-FORWARD 8-6 

[D CURSOR-BACKWARD 8-4 

[f HORIZONTAL-AND-VERTICAL-POSITION ... 8-13 

[g TABULATION-CLEAR 8-25 

[H CURSOR-POSITION 8-7 

[h SET-MODE 8-24 

[I CURSOR-HORIZONTAL-TAB 8-6 

[J ERASE-IN-DISPLAY 8-12 

[K ERASE-IN-LINE 8-12 

[L INSERT-LINE 8-16 

[I RESET-MODE 8-17 



Op 

Code Command Name Page 

[M DELETE-LINE 8-9 

[m SELECT-GRAPHIC-RENDITION 8-23 

[n DEVICE-STATUS-REPORT 8-10 

[P DELETE-CHARACTER 8-9 

[S SCROLL-UP 8-21 

[T SCROLL-DOWN 8-20 

[X ERASE-CHARACTER 8-11 

[Z CURSOR-BACKWARD-TAB 8-5 

b ENABLE-MANUAL-INPUT 8-11 

c ncoc i- i vj-im i imi_-o iAic n-ig 

D INDEX 8-15 

E NEXT-LINE 8-16 

H HORIZONTAL-TAB-SET 8-14 

M REVERSE-INDEX 8-19 

7 SAVE-CURSOR 8-19 

q DccTnocri iDcnn «.1R 

KJ I ICW l \J\ ll_-\^WI tt^V^li ^ "" 

DISABLE-MANUAL-INPUT 8-10 
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KEYWORD-IN-CONTEXT INDEX 



This index is a "Keyword in Context" index. A Keyword in 
Context index contains an entry for each significant word in 
the command name. For example, the INCLUDE-COPY-OF- 
SEGMENT command can be found under C, I, and S as 
follows: 

Include Copy of Segment 

Include Copy of Segment 
Include Copy of Segment 

Since many 41 1 Series command names begin with "Set," 
the word "set" is not included as a keyword for indexing 
purposes. 



TEK COMMANDS 



Set Page Full Action,7-291 

Activate LPOS.7-2 
Enter Alpha Mode,7-92 
Select Alphatext Size Group, 7-1 89 
Set Alphatext Font,7-1 98 
Set Alphatext Size,7-1 99 
Set 401 4 Alphatext Size,7-372 
Set Dialog Area Alternate lndex,7-229 
Set Pick Aperture,7-299 
Enable Dialog Area,7-76 

Set Dialog Area Alternate Index, 7-229 
Set Dialog Area Buffer Size,7-230 
Set Dialog Area Chars,7-231 
Set Dialog Area lndex,7-232 
Set Dialog Area Lines,7-234 
Set Dialog Area Position, 7-235 
Set Dialog Area Surface,7-236 
Set Dialog Area Visibility,7-237 
Set Dialog Area Writing Mode,7-239 
Set GIN Area,7-255 
Set Graphics Area Writing Modc,7-269 
Arm For Block Mode,7-4 
Array Parameter Types,7-6 
!ni Array Report,7-1 29 
Port Assign,7-147 
Set View Attributes,7-364 



B 

Set Background Color,7-201 
Set Background Gray Level,7-203 
Set Background lndices,7-204 
Set Baud Rates,7-206 
Set Port Baud Rate,7-308 

BAUDRATE,7-206 
Set Pixel Beam Position,7-303 
Begin Fill Pattern,7-8 
Begin Graphtext Character, 7-10 
Begin Higher Segment,7-1 2 
Begin Lower Segment,7-13 
Begin New Segment,7-14 
Begin Panel Boundary,7-16 
Begin Pixel Operations,7-20 
Begin Segment,7-23 
b l Character, 7-26 
BHEADERS, 7-210 
Set Port Stop Bits,7-316 
Set Stop Bits,7-345 

BLENGTH.7-212 
BLINELENGTH,7-213 
Arm For Block Mode,7-4 

Block Control Bytes,7-27 
Set Block Continue Chars,7-208 
Set Block End Chars,7-209 
Set Block Headers,7-210 
Set BlockLength,7-212 
Set Block Line Length,7-213 
Set Block Master Chars.7-21 4 
Set BlockNonXmtChars,7-215 
Set Block Packing,7-21 7 
Set Block Timeout, 7-21 9 
Set DMA Block Size,7-240 
BLOCKMODE.7-4 
BMASTERCHARS7-21 4 
BNONXMTCHARS7-21 5 
BORDER Key, 7-31 
Set Border Visibility,7-220 
Begin Panel Boundary,7-16 

Set Draw Boundary Mode,7-241 
BPACKING7-217 
BREAK Key,7-32 
Set Break Time,7-221 
BREAKTIME7-221 
B s Character,7-33 
BTIMEOUT7-219 
Set Dialog Area Buffer Size,7-230 

Bypass Cancel Char,7-34 
Enter Bypass Mode, 7-94 
Set Bypass Cancel Char, 7-222 
BYPASSCANCEL,7-222 
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Bypass Cancel Char,7-34 
CANCEL.7-35 
Set Bypass Cancel Char, 7-222 
CANCEL Key,7-36 
Bypass Cancel Char ,7-34 

Char Report,7-38 
Set Bypass Cancel Char,7-222 
Begin Graphtext Character, 7-1 
b l Character,7-26 
B s Character,7-33 
c r Character,7-46 
d t Character,7-50 
Delete Graphtext Character,7-53 
End Graphtext Character, 7-89 
E c Character,7-102 
h t Character,7-121,8-14 
Key Execute Character,7-129 
l f Character, 7-1 29 
Set Key Execute Character, 7-280 
u s Character,7-388 
v t Character,7-390 
Set Tablet Header Characters,7-357 
Set Block Continue Chars,7-208 
Set Block End Chars,7-209 
Set Block Master Chars,7-214 
Set Block Non Xmt Chars,7-21 5 
Set Dialog Area Chars,7-231 
Set Edit Chars,7-244 
SetEOM Chars,7-249 
Set Report Sig Chars,7-325 
Set Current Matching Class,7-228 
Set Segment Class,7-327 

CLEAR Key,7-39 
Clear Dialog Scroll, 7-40 
Set View Display Cluster, 7-366 
CMAP.7-346 
CMODE.7-224 
Select Code,7-191 
Set Background Color,7-201 

Set Color Copier Data Resolution, 7-223 
Set Color Mode,7-224 
Set Surface Color Map,7-346 

Report Colorhardcopy Status, 7-1 68 
Set Block Continue Chars,7-208 

Set Coordinate Mode,7-226 
Set Color Copier Data Resolution, 7-223 
Set Number Of Copies,7-288 

HARD COPY Key,7-120 

COPY,7-43 
Include Copy Of Segment,7-1 23 
Pixel Copy, 7-1 43 
Port Copy, 7-1 49 

°n Character, 7-46 
CRLF Command,7-47 
Set Current Matching Class,7-228 
Set GIN Cursor, 7-257 



DABUFFER.7-230 
DACHARS7.7-231 
DAINDEX.7-232 
DALINES.7-234 
DAMODE.7-239 
DAPOSITION7-235 
DASURFACE.7-236 
DAVIS.7-237 
Set Color Copier Data Resolution,7-223 
Define Macro,7-48 
Fill Pattern Definition,7-105 
Panel Definition,7-142 
Fill Pattern Definition,7-105 
Set Surface Definitions, 7-349 
d t Character,7-50 
Set Transmit Delay ,7-361 
DELETE.7-52 
Delete File, 7-52 

Delete Graphtext Character, 7-53 
Delete Segment,7-55 
Delete View,7-57 
Ignore Deletes,7-122 
Set Segment Detectability ,7-329 

Device Status Report,7-63 
Report Device Status,7-1 69 
DIALOG Key,7-66 
Clear Dialog Scroll, 7-40 
Enable Dialog Area,7-76 

Set Dialog Area Alternate Index, 7-229 
Set Dialog Area Buffer Size,7-230 
Set Dialog Area Chars, 7-231 
Set Dialog Area lndex,7-232 
Set Dialog Area Lines,7-234 
Set Dialog Area Position ,7-235 
Set Dialog Area Surface,7-236 
Set Dialog Area Visibility, 7-237 
Set Dialog Area Writing Mode, 7-239 
Directory,7-67 
Disable GIN.7-69 
Disable 4953 Tablet GIN.7-70 
Dismount, 7-71 
Set GIN Display Start Point, 7-259 
Set Segment Display Priority,7-331 
Set View Display Cluster,7-366 
Set DMA Block Size, 7-240 

Draw,7-72 
Set Draw Boundary Mode,7-241 
Draw Marker,7-73 
Draw Rectangle,7-74 
DUPLEX.7-242 
Set Duplex Mode,7-242 
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ECHO.7-243 


Set Echo,7-243 


Set Edit Chars.7-244 


EDITCHARS.7-244 


Enable Dialog Area, 7-76 


Enable GIN.7-79 


Enable 401 OGIN.7-83 


Enable 4953 Tablet GIN, 7-85 


End Fill Pattern,7-88 


End Graphtext Character,7-89 


End Panel,7-90 


End Segment,7-91 


Set Block End Chars,7-209 


Enter Alpha Mode,7-92 


Enter Bypass Mode,7-94 


Enter Marker Mode, 7-96 


Enter Vector Mode,7-97 


Set EOF String,7-246 


Set Fort EOF 3tring,7-309 


EOFSTRING.7-246 


Set Port EOLString,7-311 


Set EOL String,7-248 


EOLSTRING,7-248 


Set EOM Chars,7-249 


Set Report EOM Frequency,7-321 


EOMCHARS.7-249 


Error Report,7-1 01 


Set Error Threshold, 7-250 


ERRORLEVEL.7-250 


Report Errors,7-170 


E cCharacter,7-102 


Key Execute Character, 7-1 29 


Set Key Execute Character,7-280 


Expand Macro,7-103 


F 
Set Pixel Writing Factors,7-306 


Delete File,7-52 


Protect File,7-154 


Rename File,7-164 


Begin Fill Pattern, 7-8 


Fill Pattern Definitional 05 


End Fill Pattern,7-88 


Fill Pattern Definitional 05 


Rectangle Fill,7-163 


Set Panel Filling Mode,7-293 


Set GIN Stroke Filtering,7-266 


FIXUP.7-251 


Set Fixup Level,7-251 



FLAGGING7.253 


Set Flagging Mode,7-253 


Set Port Flagging Mode, 7-31 2 


SetAlphatext Font,7-198 


Set Graphtext Font.7-270 


Set Graphtext Font Grid,7-272 


FORMAT,7-106 


Format Volume,7-1 06 


Set Report EOM Frequency, 7-321 


Set Page Full Action.7-291 


G 
GAMODE.7-269 


Disable GIN.7-69 


Disable 4953 Tablet GIN,7-70 


Enable GINJ-79 


Enable 4010 GIN.7-83 


Enable 4953 Tablet GIN.7-85 


GIN Locator Report,7-108 


GiN Pick Report,7-109 


GIN Report Sequence, 7-1 1 1 


GiN Stroke Report,7-1 14 


Report GINPoint,7-171 


Set GIN Area,7-255 


Set GIN Cursor,7-257 


Set GIN Display Start Point,7-259 


Set GIN Gridding,7-260 


Set GIN lnking,7-262 


Set GIN Rubberbanding,7-264 


Set GIN Stroke Filtering,7-266 


Set GINWindow,7-268 


4010 GIN Report,7-397 


4953 Tablet GIN Report,7-402 


Graphic Text,7-1 16 


Set Graphics Area Writing Mode,7-269 


Begin Graphtext Character, 7-10 


Delete Graphtext Character,7-53 


End Graphtext Character,7-89 


Set Graphtext Font,7-270 


Set Graphtext Font Grid,7-270 


Set Graphtext Precision,7-274 


Set Graphtext Rotation,7-275 


Set Graphtext Size,7-276 


Set Graphtext Slant,7-277 


Set Background Gray Level,7-203 


Set Surface Gray Levels,7-351 


Set Graphtext Font Grid,7-272 


GRIDDING,7-260 


Set GiN Gridding,7-260 


Select Alphatext Size Group,7-189 
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H 



HARD COPY Key,7-120 
Hardcopy,7-118 
Select Hardcopylnterface,7-195 
4010 Hardcopy,7-399 
Set Tablet Header Characters,7-357 
Set Block Headers,7-210 

Begin Higher Segment,7-1 2 
Set Segment Highlighting, 7-332 
H TCharacter,7-121 



I 



Set Pick ID.7-300 




Ignore Deletes,7-1 22 


Set 


Image Orientation, 7-278 


Set Segment Image Transform,7-334 




Include Copy of Segment,7-123 


Set Dialog Area Alternate 


lndex,7-229 


Set Dialog Area 


lndex,7-232 


Set Line lndex,7-281 


Set Text lndex,7-360 


EOM 


lndicator,7-100 


Set Background 


lndices,7-204 


Set GIN 


lnking,7-262 




Int Array Report,7-129 




lntReport,7-127 




lntcReport,7-128 


Select Hardcopy lnterface,7-195 


BORDER 


K 
Key,7-31 


BREAK 


Key,7-32 


CANCEL 


Key,7-36 


CLEAR 


Key,7-39 


DIALOG 


Key,7-66 


HARD COPY 


Key,7-120 




Key Execute Character, 7-1 29 


LOCAL 


Key,7-132 


NEXTVIEW 


Key,7-138 


NORMAL 


Key,7-138 


OVERVIEW 


Key,7-139 


PAGE 


Key,7-141 


PAN 


Key,7-141 


RESTORE 


Key ,7-1 80 


Set 


Key Execute Character, 7-280 


SETUP 


Key,7-374 


VIEW 


Key,7-389 


ZOOM 


Key,7-396 


Lock 


Keyboard, 7-1 33 


Lock Viewing 


Keys,7-134 



Set Block 


Length,7-212 


Set Block Line 


Length,7-213 


Set Report Max Line 


Length,7-323 


ERROR 


LEVEL,7-250 


Set Background Gray 


Level,7-203 


Set Fixup 


Level,7-251 


Set Surface Gray 


Levels,7-351 




L FCharacter,7-129 




LFCRCommand,7-130 


Set Transmit Rate 


Limit,7-362 


Set Block 


LineLength,7-213 


Set 


Line lndex,7-281 


Set 


Line Style,7-282 


Set 


LineWidth,7-283 


Set Report Max 


Line Length,7-323 


Set 4014 


Line Style, 7-373 


Set Dialog Area 


Lines, 7-234 




LOAD.7-131 




Load.7-131 




LOCAL Key, 7-1 32 


GIN 


Locator Report,7-108 




Lock Keyboard,7-1 33 




Lock Viewing Keys,7-134 


Begin 


Lower Segment,7-1 3 




LPOS.7-2 


Activate 


LPOS.7-2 


M 
Define Macro,7-48 


Expand 


Macro,7-103 




Map Index to Pen,7-1 35 


Set Surface Color 


Map,7-346 




MARGIN.7-284 


Set 


Margins,7-284 


Draw Marker,7-73 


Enter 


Marker Mode,7-96 


Set Marker Type,7-286 


Set Block Master Chars,7-214 


Set Current 


Matching Class, 7-228 


Set Report 


Max Line Length, 7-323 


Arm For Block Mode,7-4 


Enter Alpha 


Mode,7-92 


Enter Bypass 


Mode,7-94 


Enter Marker Mode,7-96 


Enter Vector Mode,7-97 


Prompt 


Mode,7-153 


Set Color Mode,7-224 


Set Coordinate Mode,7-226 


Set Dialog Area Writing 


Mode,7-239 


Set Draw Boundary 


Mode,7-241 


Set Duplex 


Mode,7-242 


Set Flagging 


Mode,7-253 


Set Panel Filling 


Mode,7-293 


Set Port Flagging 


Mode,7-312 


Set Segment Writing 


Mode,7-341 


Set Snoopy 


Mode,7-344 




Move,7-137 
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N 

Begin NewSegment,7-14 
NEXTVIEWKey,7-138 
Set Block NonXmtChars,7-215 
NORMAL Key,7-1 38 
Set Number Of Copies,7-288 
Set User Number,7-363 



Begin Pixel Operations,7-20 
Set Image Orientation, 7-278 

OVERVIEW Key,7-1 39 
Set Overview Window,7-289 



Set Block Packing,7-217 
PAGEKey,7-141 
Page,7-140 
Set Page Full Action,7-291 
PANKeyJ-141 
Begin Panel Boundary, 7-1 6 
End Panel,7-90 
Set Panel Filling Mode,7-293 

PARITY.7-298 
Set Parity,7-298 
Set Port Parity ,7-31 4 
Begin Fill Pattern,7-8 

Fill Pattern Definition, 7-1 05 
End Fill Pattern,7-88 

Fill Pattern Definition,7-1 05 
Select Fill Pattern,7-192 
PBAUD.7-308 
PBITS.7-316 
PCOPY.7-43 
Map Index to Pen, 7-1 35 
PEOF,7-309 
PEOL.7-311 
PFLAG.7-312 
GIN PlckReport,7-109 
Set Pick Aperture,7-299 
Set PicklD,7-300 
Set Pivot Point,7-302 
Begin Pixel Operations,7-20 
Pixel Copy,7-1 43 
Set Pixel Beam Position,7-303 
Set Pixel Viewport,7-304 
Set Pixel Writing Factors,7-306 
PLOT ,7-1 45 
PMAP 
Report GIN Point,7-171 
Set GIN Display Start Point,7-259 
Set Pivot Point,7-302 



Port Assign,7-1 47 
PortCopy,7-149 
Port Status Report,7-151 
Report PortStatus,7-173 
Set Port Baud Rate,7-308 
Set Port EOF String„7-309 
Set Port EOL String,7-31 1 
Set Port Flagging Mode,7-31 2 
Set PortParity,7-314 
Set PortStopBits,7-316 
Set Dialog Area Position,7-235 
Set Pixel Beam Position,7-303 
Set Segment Position,7-337 
PPARITY.7-314 
Set Graphtext Precision,7-274 
Set Surface Priorities,7-354 
Set Segment Display Priority.7-331 

Prompt Mode,7-1 53 
Set Prompt String,7-31 8 
PROMPTMODE.7-153 
PROMPTSTRING.7-318 
PROTECT.7-154 
Protect File, 7-1 54 



Set QueueSize.7-319 
QUEUESIZEJ-319 



Set Port Baud Rate,7-308 
Set Transmit Rate Limit,7-362 
Set Baud Rates,7-206 

RealReport,7-162 
Draw Rectangle,7-74 

Rectangle Fill,7-163 
RENAME 

Rename Fiie,7-1 64 
Rename Segment,7-166 
RENEW.7-167 
Renew View,7-1 67 
REOM.7-321 
Char Report,7-38 
Colorhardcopy Status Report,7-41 
Device Status Report,7-63 
Error Report,7-101 
GIN Locator Report,7-108 
GIN Pick Report,7-109 

GIN Report Sequence,7-1 1 1 

GIN Stroke Report.7-114 

Int Report,7-127 

Intc Report,7-128 

Int Array Report.7-129 

Port Status Report,7-151 
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Real 



Segment Status 

Set 

Set 

Set 

String 

Terminal Settings 

4010 GIN 

4010 Status 

4953 Tablet GIN 

Set Color Copier Data 



Set Graphtext 
Set GIN 



Report,7-162 

Report Colorhardcopy Status,7-1 68 

Report Device Status,7-169 

Report Errors,7-1 70 

Report GIN Point,7-1 71 

Report Port Status,7-1 73 

Report Segment Status,7-174 

Report Terminal Settings,7-176 

Report 4010 Status,7-178 

Report,7-186 

Report EOM Frequency,7-321 

Report Max Line Length,7-323 

Report Sig Chars,7-325 

Report ,7-382 

Report,7-383 

Report,7-397 

Report,7-400 

Report,7-402 

Reset,7-179 

Resolution, 7-223 

RESTORE Key, 7-1 80 

RLINELENGTH.7-323 

Rotation,7-275 

Rubberbanding, 7-264 

RunlengthWrite,7-l8l 



Report Terminal 
Terminal 





SAVE.7-183 




Save,7-183 


Clear Dialog 


Scroll,7-40 


Begin Higher Segment,7-12 


Begin Lower 


Segment,7-13 


Begin New 


Segment,7-14 


Begin Segment,7-23 


Delete 


Segment,7-55 


End 


Segment,7-91 


Include Copy of 


Segment,7-123 


Rename 


Segment,7-166 


Report Segment Status, 7-1 74 




Segment Status Report,7-l 86 


Set 


Segment Class,7-327 


Set 


Segment Detectability, 7-329 


Set 


Segment Display Priority, 7-331 


Set 


Segment Highlighting,7-332 


Set 


Segment Image Transform,7-334 


Set 


Segment Position,7-337 


Set 


Segment Visibility, 7-339 


Set 


Segment Writing Mode,7-341 




Select Alphatext Size Group.7-1 89 




Select Code,7-1 91 




Select Fill Pattern,7-192 




Select Hardcopy lnterface,7-195 




Select View,7-1 96 


GIN Report Sequence,7-1 1 1 



Set Report 

Select Alphatext 

Set Alphatext 

Set Dialog Area Buffer 

Set DMA Block 

Set Graphtext 

Set Queue 

Set Tablet 

Set 401 4 Alphatext 

Set Graphtext 

Set 

Stop 
Set GIN Display 

Device 

Port 

Report Colorhardcopy 

Report Device 

Report Port 

Report Segment 

Report 4010 

Segment 

Set Tablet 

4010 

Set Port 
Set 



Set Tablet Status 

EOF 

EOL 

Set EOF 

Set EOL 

Set Port EOF 

Set Port EOL 

Set Prompt 

GIN 

Set GIN 

Set Line 

Set 4014 Line 

Set Dialog Area 

Set 

Set 

Set 

Set 

Set 



Settings,7-176 

Settings Report,7-383 

SETUP Key,7-374 

Sig Chars,7-325 

SizeGroup.7-189 

Size,7-199 

Size,7-230 

Size,7-240 

Size,7-276 

Size,7-319 

Size,7-358 

Size,7-372 

Slant,7-277 

SNOOPY.7-344 

Snoopy Mode,7-344 

SPOOL.7-376 

Spooling, 7-380 

Start Point,7-259 

STATUS.7-379 

Status Report,7-63 

Status Report,7-1 51 

Status, 7-1 68 

Status,7-169 

Status,7-173 

Status,7-174 

Status,7-178 

Status Report,7-1 86 

Status Strap,7-359 

Status Report,7-400 

STOP.7-380 

StopBits,7-316 

Stop Bits,7-345 

Stop Spooling,7-380 

STOPBITS.7-345 

Strap,7-359 

String Report,7-382 

String,7-98 

String,7-99 

String,7-246 

String,7-248 

String,7-309 

String,7-31 1 

String,7-318 

String Report,7-382 

Stroke Report,7-1 14 

Stroke Filtering,7-266 

Style,7-282 

Style,7-373 

Surtace,7-236 

Surface Color Map, 7-346 

Surface Definitions, 7-349 

Surface Gray Levels,7-351 

Surface Priorities,7-354 

Surface Visibility,7-356 



6-6 



41 1 SERIES COMMAND REFERENCE 



KEYWORD IN CONTEXT 



Disable 4953 Tablet GIN.7-70 
Enable 4953 Tablet GIN, 7-85 

Set Tablet Header Characters,7-357 
Set Tablet Size,7-358 
Set Tablet Status Strap,7-359 
4953 Tablet GIN Report,7-402 
TBHEADERCHARS.7-298 
TBSTATUS.7-379 
Report Terminal Settings,7-1 76 

Terminal Settings Report,7-383 
Graphic Text,7-116 

Set Text lndex,7-360 
Set Error Threshold,7-250 
Set Break Time,7-221 
Set Block Timeout, 7-21 9 
Set Segment image Transform, 7-334 

Set Transmit Delay, 7-361 
Set Transmit Rate Limit,7-362 
Set Marker Type,7-286 



Set Block Non XmtChars,7-215 
XMTDELAY.7-361 
XMTLIMIT.7-362 



ZOOM Key.7-396 



Enable 4010GIN.7-83 

Report 4010Status,7-178,7-379 
4010 GIN Report,7-397 
4010Hardcopy,7-399 
4010 Status Report,7-400 
Set 401 4 Alphatext Size,7-372 
Set 4014 Line Style, 7-373 

Disable 4953 Tablet GIN,7-70 

Enable 4953 Tablet GIN.7-85 

4953 Tablet GIN Report,7-402 



U 

u s Character, 7-388 
Set User Number,7-363 



Enter Vector Mode,7-97 
NEXT VIEWKey,7-138 
VIEW Key,7-389 
Delete View,7-57 
Renew View,7-167 
Select View,7-196 

Set View Attributes,7-364 
Set View Display Cluster, 7-366 
Lock Viewing Keys,7-1 34 
Set Pixel ViewpQrt,7-304 
Set Viewport,7-368 
Set Border Visibility,7-220 
Set Dialog Area Visibility,7-237 
Set Segment Visibility ,7-339 
Set Surface Visibility, 7-356 
Format Volume, 7-1 06 

v t Character,7-390 

W 

Set Line Width,7-283 
Set GIN Window,7-268 
Set Overview Window,7-289 
Set Window,7-370 
Raster Write, 7-1 55 
Runlength Write.7-181 
Set Pixel Writing Factors,7-306 
Set Dialog Area Writing Mode,7-239 
Set Graphics Area Writing Mode,7-269 
Set Segment Wrfting Mode,7-341 
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ANSI COMMANDS 



B 

Cursor Backward,8-4 
Cursor Backward Tab, 8-5 



Delete Character,8-9 

Erase Character,8-1 1 

Insert Character,!}- 1 5 
Tabulation Clear,8-25 

Cursor Backward,8-4 
Cursor Backward Tab,8-5 
Cursor Down,8-5 
Cursor Forward,8-6 
Cursor Horizontal Tab,8-6 
Cursor Position ,8-7 
Cursor Up,8-8 
Restore Cursor,8-18 

Save Cursor,8-19 



Delete Character,8-9 
Delete Line,8-9 
Device Status Report,8-I0 
Disable Manual Input,8-10 
Erase In Display ,8-1 2 
Cursor Down, 8-5 
Scroll Down, 8-20 



Insert Character,8-1 5 
Insert Line,8-1 6 



Delete Line,8-9 

Erase In Line,8-12 

Insert Line,8-16 

Next Line,8-16 

M 

Disable Manual Input, 8-10 
Enable Manual Input,8-1 1 
Reset Mode,8-17 
Set Mode,8-24 

N 
NextLine,8-16 



Cursor Position,8-7 
Horizontal And Vertical Position,8-13 



Select Graphic Rendition, 8-23 

Device Status Report,8-10 

Reset Mode,8-17 
Reset To Initial State,8-18 
Restore Cursor,8-1 8 
Reverse lndex,8-19 



Enable Manual Input,8-1 1 
Erase Character,8-1 1 
Erase In Display,8-12 
EraselnLine,8-12 



Cursor Forward,8-6 



Select Graphic Rendition,8-23 

H 

Cursor Horizontal Tab, 8-6 

Horizontal And Vertical Position, 8-1 3 
Horizontal Tab Set ,8-1 4 



lndex,8-15 

Reverse Index, 8-1 9 

Reset To Initial State,8-1 8 

Disable Manual lnput,8-10 

Enable Manual lnput,8-11 



Save Cursor,7-183,8-19 

Scroll Down,8-20 

Scroll Up,8-21 

Select Graphic Rendition, 8-23 

Set Mode,8-24 
Horizontal Tab Set,8-14 
Reset To Initial State,8-18 

Device Status Report,8-10 



Cursor Backward Tab,8-5 
Cursor Horizontal Tab,8-6 

Horizontal TabSet,8-14 

Tabulation Clear,8-25 



U 

Cursor Up,8-8 
Scroll Up,8-21 



Horizontal And Vertical Position, 8-1 3 
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TEK COMMANDS AND SYNTACTIC CONSTRUCTS 



This section lists all the TEK commands, as well as mes- 
sage formats, data formats, parameter types (int, string, 
etc.) and reports sent to the host (GIN-report-sequence, 
GIN -locator-report, etc.). 



only valid for a certain option or for certain terminals, those 
terminals or options are listed in the upper-right corner of 
the first page of the command description. Figure 7-1 shows 
a sample command description. 



Command descriptions include the syntax of the command, 
an explanation of the command's parameters (if any), the 
function of the command, defaults for the command's 
parameters (if any), errors that may occur, and references to 
related commands and syntactic constructs. If a command is 



If you do not know the name of a command, refer to Sec- 
tions 3, 4, 5, or 6, the indexing and cross-referencing 
sections. Most command names express the action that 
the command performs, such as SET-BAUD-RATES, 
SET-LINE-INDEX, and ENABLE-GIN. 





SELECT-HARDCOPY-INTERFACE Command option 09 
Host Syntax 






E cQD mV.interface 






Setup Syntax 






HCINTERFACE s e interface 






PARAMETERS DEFAULTS 

interface (0 or 1 ). interface 

Specifies which hardcopy interface is used when the as shipped — 

terminal receives a hardcopy command. Setup mode on power-up — remembered 

parameters are MONO and COLOR. if omitted — 

MONO: the standard hardcopy interface, to 

which can be connected TEKTRONIX 461 2 ERRORS 
and 4632 Video Hard Copy Units. 

1 COLOR: the Option 9 hardcopy interface, QDOO (Level 0): Unrecognized command (Option 9 is not 
to which can be connected a TEKTRONIX installed). 

4691 Color Graphics Copier. QD1 1 (Leve| 2) . |nva|jd imer j ace pararn eter (0 and 1 are 

valid). 

DESCRIPTION 

REFERENCES 

The SELECT-HARDCOPY-INTERFACE command selects 

the hardcopy interface that is used when the terminal HARDCOPY command 
receives a HARDCOPY command or a 401 0-HARDCOPY 401 o. HARDCOP y command 
Dommand, or when the HARD COPY key is pressed. This 
:ommand chooses between the standard hardcopy inter- 
ace and the Option 9 color hardcopy interface. This com- 
mand is recognized only by a 41 1 3 or 41 1 5 terminal with 
Option 9 installed. 


3892-50 



Figure 7-1. Sample Command Page. 
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ACTIVATE-LPOS Command 



OPTIONS 42, 43, 45 



Host Syntax 



E cJB dev\ce:boot-file 



Setup Syntax 



LPOS s p boot-file 



PARAMETERS 

boot-file. 

Device name and/or filename from which to boot local 
programmability. Valid devices are Option 42, 43, and 
45 disk devices and files on those devices. 



DESCRIPTION 

This command activates the local programmability operat- 
ing system (LPOS). If the operating system has not been 
loaded (is not resident in terminal memory), then this com- 
mand loads it from a file on the disk mounted on the speci- 
fied drive. 



LPOS Not Loaded 

The following are the four possible boot actions that you 
may specify (by entering the parameter in different ways) 
when LPOS is not resident in terminal memory: 

• If the parameter is completely omitted, then LPOS boots 
from the file default operating system file in user area 1 5 
of the default drive (FO: if Option 42 or 43 is installed, or 
the first device connected to the Option 45 interface). 



• If the parameter is a filename without a device specifier, 
LPOS boots from the given file in user area 1 5 of the 
default drive (see above). 

• If a device is specified without an explicit filename, LPOS 
boots from the default operating system file in user area 

1 5 of the specified drive. 

• If both device and filename are specified, then LPOS 
boots from the specified file in user area 15 of the speci- 
fied device. 

The default operating system filename is: 

• If the terminal firmware version number is one digit, 
then the filename is LPv.SYS where "v" is the version 
number (e.g. LP4.SYS). 

• If the terminal firmware version number of two digits, 
then the filename will be Lw.SYS where " w" is the 
version number. 



LPOS Loaded 

If LPOS is resident in terminal memory, then the following 
may occur: 

• If the boot-file parameter is specified, error JB03 is 
generated. 
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• If the parameter is omitted but LPOS has not been de- 
activated by the LPOS SLEEP command, error JB03 
is generated. 

• If the parameter is omitted and LPOS has been de- 
activated by the LPOS SLEEP command, then this 
command activates LPOS so that it resumes its task 
from where it left off. 

See the 4110 Series CP/M-86 System Overview Manual for 
information on the LPOS SLEEP command. 

wneniheierrninai receives uiisuuuiiiianu, nu™t»»~ «~ 
operating system immediately. When an operator issues 
this command from Setup mode, the operating system is 
activated but Setup is not disabled. Setup mode super- 
sedes local programmability, so you must exit Setup mode 
before local programs can run. You can enter Setup mode 
«*~« «« w^.. u> e n4 hn+ \«M i fannnt mq(=> lo^a' oroarams 

until you exit Setup mode. 

When local programmability is activated, the LED in the 
LOCAL key is turned on and further communications from 
the host are placed in the input queue (as if the terminal 
were in Local mode). The operating system remains active 
until the terminal is reset or turned off, or until the local 
programmability SLEEP command is issued. 

While local programmability is active, if the LED in the 
LOCAL key is on, an operator can interact directly with the 
operating system or a local program. When the LOCAL 
key light is off, the terminal reacts normally to host com- 
munication. 



DEFAULTS 

boot-file. 

as shipped — none 

on power-up — none 

if omitted — see previous description 



ERRORS 

JBOO (Level 0): 

JB03 (Levei 2): 

JB10 (Level 2): 

JB11 (Level 2): 

JB12 (Level 3): 

JB13 (Level 2): 



Unrecognized command (option 42/4%5 
or Version 6 or higher not installed) 

A filename was specified when LPOS was 
resident in terminal memory, or a filename 
was not specified, but LPOS was active. 

The boot-file was not found. 

Illegal filename. 

Out of memory while performing 
command. 

Invalid device specifier, invalid medium 
format or the file is currently being 
written. 

JB1 9 (Level 2): The drive is not ready or a hardware error 
occurred while reading from the drive. 



REFERENCES 

4110 Series CP/M-86 System Overview Manual 
Device parameter type 
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ARM-FOR-BLOCK-MODE Command 



OPTION 01 



Host Syntax 



E cOB \n\:block-mode-arming 



Setup Syntax 



BLOCKMODE s p block-mode-arming 



PARAMETERS 

Block-mode-arming (0 or 1). 

Arms or disarms the terminal to accept block-mode 
transmission. 

Disarms the terminal so that it will not enter 
block mode. Setup parameter is NO. 

1 Arms the terminal to enter block mode with 
receipt of the next block header. Setup 
parameter is YES. 



DESCRIPTION 

This command determines whether the terminal will enter 
Block mode when it receives a block header. If the int 
parameter is 1 , the terminal is armed for Block mode 
and will enter Block mode when it receives the receive 
block header specified by the most recent SET-BLOCK- 
HEADERS command. 



Before arming the terminal for Block mode, set all neces- 
sary Block mode parameters commands. The commands 
that set these parameters (except for SET-BLOCK- 
TIMEOUT) are invalid when the terminal is armed for Block 
mode. A list of these commands is found under "Refer- 
ences" at the end of this command description. 

Before arming the terminal for Block mode, be sure that the 
terminal's communications input queue is large enough to 
hold an entire block. Use the SET-QUEUE-SIZE command 
to make the communications queue larger, or use the SET- 
BLOCK-LENGTH command to make the block size smaller. 

The Block mode protocol effectively suppresses any remote 
echoes that the host provides. So, before placing the termi- 
nal in Block mode, issue a SET-ECHO command so that the 
terminal will provide its own local echo of characters typed 
by an operator. 

DEFAULTS 



If the int parameter is 0, subsequent block headers will not 
put the terminal in Block mode. 




If you do not intend to use Block mode, do not arm 
the terminal for Block mode. The terminal cannot 
recognize EOF-strings coming from the host com- 
puter when armed for Block mode. So, when the 
terminal is armed for Block mode, but is not yet 
actually in Block mode, the only way to terminate 
a copy or port-copy is with the CANCEL key. 



block-mode-arming 
as shipped — on 
power-up — remembered 
if omitted — 
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ERRORS 

OB00 (Level 0): Unrecognized command (Option 01 is 
not installed). 

OB03 (Level 2): The communications queue size is 
smaller than the specified input 
block size. 

OB1 1 (Level 2): Invalid block-mode-arming parameter 
(must be or 1). 



REFERENCES 

Block syntactic construct 
SET-BLOCK-CONTINUE-CHARS command 
SET-BLOCK-END-CHARS command 
SET-BLOCK-HEADERS command 
SET-BLOCK-LENGTH command 
SET-BLOCK-LINE-LENGTH command 
SET-BLOCK-M ASTER-CHARS command 
SET-BLOCK-NON-XMT-CHARS command 
SET-BLOCK-PACKING command 
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Array Parameter Types 



SYNTAX 



array = 



' int-array 
char-array 
string 
xy-array 



int-array = int[int...] 
char-array = int[char.. 
string = char-array 
xy-array = int[xy...\ 



DESCRIPTION 

The array parameter types allow lists of items to be sent to 
the terminal as one parameter. Each array starts with an 
integer (an int parameter) specifying the number of items 
that follow. If this first int is 0, then no items follow. 

For example, the string for the characters "F0:FILE1 " is: 

string: F0:FILE1 = int:8 F0:FILE1 

= 8F0:FILE1 

Here, the first character, 8, is the int parameter for the num- 
ber eight, telling the terminal that eight chars follow. 

The host computer uses the array parameter types when 
sending commands to the terminal. When the terminal 
sends reports back to the host computer, it uses a different 
format; see the description of the array-report parameter 
types. 

Within an array, the terminal ignores ASCII control charac- 
ters that are not the command terminator characters ( E c, u s, 



G s, and F s). These are characters with ASCII decimal equiv- 
alents in the range from to 26, and 30. For instance, the c r 
and h= characters are ignored when encountered within an 
array. Thus, you can break long arrays into several lines of 
text, with c r l f at the end of each line. 

The terminal does not ignore command terminator charac- 
ters ( E c, u s, G s, and F s). When it encounters an E c, u s, G s, or 
F s character within an array, it terminates both the array and 
the command for which the array is a parameter. The array 
count is adjusted to show the number of array items that 
were actually received before the E c, u s, G s, or F s character. 
See Section 2 for more information about the command 
terminator characters. 



REFERENCES 

Array-Report parameter types 
Char parameter type 
Int parameter type 
XY parameter type 
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SYNTAX 



array-report 



(int-array-report \ 
char-array-report \ 
string-report ) 



int-array-report = int-report[int-report...] 



ui iai -ai 1 ety-i cfjui i 



string-report = char-array-report 



DESCRIPTION 

The terminal uses the array-report parameter types when 
reporting values of array parameters to the host computer. 
The terminal reports in response to inquiry commands, 
such as the REPORT-TERMINAL-SETTINGS command. 

The array-report syntax is similar to the array syntax, with 
int-reports used instead of ints, and char-reports used 
instead of chars. 

If the entire report does not fit on one line of text, then the 
terminal may insert one or more EOM-indicators between 
individual items in the array; that is, if the next item of the 



array (int-report or char-report) would cause the maximum 
line length to be exceeded, then that item is sent with a 
leading EOMindicator as part of its syntax. For details, see 
the descriptions of SET-REPORT-MAX-LINE-LENGTH, 
EOM-indicator, int-report, and char-report. 



REFERENCES 

Array parameter type 
EOM-indicator syntactic construct 
Char-report parameter type 
Int-report parameter type 
SET-REPORT-MAX-LINE-LENGTH command 
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BEGIN-FILL-PATTERN Command 



4112,4113,4115 



Host Syntax 



E cMD intfill-pattern-number mV.pattern-width \v\:pattern-height mtbits-per-pixel 



Setup Syntax 



e cMD s p fill-pattern-number pattern-width pattern-height bits-per-pixel 



PARAMETERS 



DESCRIPTION 



fill-pattern-number $ to 32767). 

The number of the fill pattern being defined. 

pattern-width (41 12, 41 13: 1 to 32; 41 15: 1 to 1280). 
The width of the pattern in pixels. For the 41 1 2 and 
41 13, preferred values are 1 , 2, 4, 8, 16, and 32. 

pattern-height (41 1 2, 41 1 3: to 480; 41 1 5: to 1 024). 
The height of the pattern in pixels. 

Deletes the fill pattern definition 

> Assigns pattern height 

bits-per-pixel (41 12: 1 , 2, 3, or 6; 41 13: 1 , 2, 3, 4, or 6; 
4115:1 to 8). 
Used to decode subsequent RASTER-WRITE and 
RUNLENGTH-WRITE commands. 



This command begins or deletes a fill-pattern-definition. 
A fill pattern is a rectangular array of color indices. These 
indices are all initialized to by this command. See the 
discussion of fill-pattern-definition in this section for more 
details. 

The fill-pattern-number specifies the pattern number 
assigned to the fill pattern you are creating. This can be any 
number from 1 to 32767. If a fill pattern with its same num- 
ber already exists, the previous definition is deleted and the 
new definition takes its place. 

On a 41 1 2 or 41 1 3, the pattern-width should be 1 , 2, 4, 
8, 16, or 32. Other widths in the range from 1 to 32 are 
allowed, but the remainder of the pattern to the right of the 
next lowest power of two cannot be defined. On a 41 1 5, any 
pattern-width within the valid range of 1 to 1 280 yields a 
pattern with no undefined areas. 
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On a 41 1 2 or 41 1 3, the pattern-height is any number from 
to 480. On a 41 1 5, a pattern-height can be from to 1024. 
Specifying a deletes the pattern. 

The bits-per-pixel parameter is used to decode the 
RASTER-WRITE and RUNLENGTH-WRITE commands 
that follow. This affects which color indices may occur in the 
fill pattern. 



DEFAULTS 

fill-pattern-number 
as shipped — none 
on power-up — none 
if omitted — error MD1 1 

pattern-width 

as shipped — none 
on power-up — none 
if omitted — error MD21 

pattern-height 

as shipped — none 
on power-up — none 
if omitted — error MD31 

bits-per-pixel 

as shipped — none 
on power-up — none 
if omitted — error MD41 



ERRORS 

MDOO (Level 0): Unrecognized command. (The terminal is 
nota4112, 4113, or 4115.) 

MD02 (Level 3): Not enough memory available for fill 
pattern. 

MD03 (Level 2): Another fill pattern is currently being 
defined 

MD1 1 (Level 2): Invalid fill-pattern-number (must range 
from 1 to 32767). 

MD21 (Level 2): Invalid pattern-width (41 1 2, 41 1 3: 1 to 32; 
4115:1 to 1280). 

MD31 (Level 2): \m&\\6 pattern-height (W\2, 4113: Oto 
480; 4115:0 to 1024). 

MD41 (Level 2): Invalid bits-per-pixel (41 1 2: 1 , 2, 3, or 6; 
41 1 3: 1 , 2, 3, 4, or 6; 41 1 5; 1 to 8). 

REFERENCES 

END-FILL-PATTERN command 
END-PANEL command 
Fill-pattern-definition syntactic construct 
RASTER-WRITE command 
RUNLENGTH-WRITE command 
SELECT-FILL-PATTERN command 
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BEGIN-GRAPHTEXT-CHARACTER Command 



Host Syntax 



E cST mkfont ml.character 



Setup Syntax 



E cST s p font character 



PARAMETERS 

font (0 to 32767). 

The font number in which the character being defined 
resides. 

character (32 to 126). 

The ASCII decimal equivalent of the character being 
defined. 



DESCRIPTION 

This command starts the definition of a graphtext character 
in the specified graphtext font. Before a graphtext character 
can be defined, a SET-GRAPHTEXT-FONT-GRID must be 
saved for the specified font. The character being defined 
with this command is displayed during its definition. To 
display the character after it has ben defined, all the follow- 
ing conditions must be met: 

• The current graphtext font is the same as the font named 
in the/on* parameter. (See the description of the SET 
GRAPHTEXT-FONT command.) 

• The current graphtext precision is "stroke." (See the 
description of the SET-GRAPHTEXT-PRECISION 
command.) 

• The specified ASCII character occurs within a 
GRAPHIC-TEXT command's string parameter. (See 
the description of the GRAPHIC-TEXT command.) 

When you define a character with the BEGIN-GRAPHTEXT- 
CHARACTER and END-GRAPHTEXT-CHARACTER 
commands, that character supercedes the pre-defined 
character of that graphtext character font. If you later delete 



the character definition with a DELETE-GRAPHTEXT- 
CHARACTER command, the character is restored to its 
original meaning. 

A graphtext character definition consists of a BEGIN- 
GRAPHTEXT-CHARACTER command, a number of MOVE 
and/or DRAW commands, and an END-GRAPHTEXT- 
CHARACTER command. On a 41 15, if a MOVE or DRAW 
command's coordinates are outside the range from to 
4095, error ST01 is generated, and the character definition 
is terminated. 

The character definition uses the current pivot point to posi- 
tion the font grid and to define the character origin. When 
the character is displayed, its origin is mapped onto the cur- 
rent graphic beam position. On a 41 1 5, if one of the pivot 
point coordinates is outside the range from to 4095, error 
ST03 is generated, and the character is not defined. 

The definitions of characters in predefined fonts can be 
superseded with this command. 

DEFAULTS 

font 

as shipped — none 
on power-up — none 
if omitted — 

character 

as shipped — none 
on power-up — none 
if omitted — error ST21 
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ERRORS 

ST01 (Level 2): 

ST02 (Level 3): 
ST03 (Level 2): 



ST1 1 (Level 2): 
ST20 (Level 2): 
ST21 (Level 2): 



MOVE or DRAW is out of range (41 1 5 
only: X = to 4095, Y = to 4095). 

Out of memory while defining graphtext 
character. 

Command is invalid at this time (a 
graphtext character is currently being 
defined, or the pivot-point coordinate is 
out of range X = to 4095, Y = to 4095 
(41 15 only). 

1 1 it? spcumcu iui ii uOco I IWl CAIOl \l IU 

SET-GRAPHTEXT-FONT-GRID command 
has been issued for font). 

Invalid/o/tf number (the range is from 
to 32767). 

The character specif ied has already been 
defined in Ms font. 

Invalid character number (the range is 
from 32 to 126). 



REFERENCES 

END-GRAPHTEXT-CHARACTER command 
SET-GRAPHTEXT-FONT command 
SET-GRAPHTEXT-FONT-GRID command 
SET-PIVOT-POINT command 
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BEGIN-HIGHER-SEGMENT Command 



Host Syntax 




Setup Syntax 




DESCRIPTION 

This command ends the definition of the segment which is 
currently being defined, and begins the definition of a seg- 
ment with a number (segment ID) one greater than that of 
the segment just ended. If no segment is currently being 
defined, an error is detected and no action is taken. 

The pivot point and position of the new segment are set to 
the current beam position. The current pick-id is set to 1 . 

This command is equivalent to the following sequence of 
commands: 

REPORT-TERMINAL-SETTINGS: SO (returns open 

segment number) 
END-SEGMENT 

REPORT-GIN-POINT: -2 (returns current beam xy) 
REPORT-TERMINAL-SETTINGS: SP (returns current 

pivot pointy) 
REPORT-SEGMENT-STATUS: -2, X (returns default 

segment position xy) 
SET-PIVOT-POINT: (current beam xy) 
BEGIN-SEGMENT: (next higher segment ID) 
SET-PIVOT-POINT: (previous pivot point xy) 
SET-SEGMENT-POSITION: -2, (default segment 

position xy) 

The segment definition can be terminated by an END- 
SEGMENT command, a BEGIN-NEW-SEGMENT com- 
mand, a BEGIN-LOWER-SEGMENT command, or another 
BEGIN-HIGHER-SEGMENT command. 

When a segment created with this command is saved with 
the SAVE command, the segment definition is saved using 



the BEGIN-SEGMENT command instead of the BEGIN- 
HIGHER-SEGMENT command, since all segments are the 
same once they are created. 



ERRORS 

SNOO (Level 0): 

SN00 (Level 2): 
SN01 (Level 2): 

SN02 (Level 3): 

SN03 (Level 2): 



Unrecognized command (the terminal 
firmware is version 1 or 2). 

The indicated segment already exists. 

Invalid value for next higher segment 
number (current segment ID is 32767). 

Out of memory while ending or beginning 
segment definition. 

Context error; command is invalid at this 
time. No segment is currently being 
defined, or a graphtext character is cur- 
rently being defined. 



REFERENCES 

BEGIN-LOWER-SEGMENT command 
BEGIN-NEW-SEGMENT command 
BEGIN-SEGMENT command 
END-SEGMENT command 
REPORT-GIN-POINT command 
REPORT-SEGMENT-STATUS command 
REPORT-TERMINAL-SETTINGS command 
SET-PIVOT-POINT command 
SET-PICK-ID command 
SET-SEGMENT-POSITION command 
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BEGIN-LOWER-SEGMENT Command 



Host Syntax 




Setup Syntax 




DESCRIPTION 

This command ends the definition of the segment which is 
currently being defined, and begins the definition of a seg- 
ment with a number (segment ID) one less than that of the 
segment just ended. If no segment is currently being 
defined, an error is detected and no action is taken. 

The pivot point and position of the new segment are set to 
the current beam position. The current pick-id is set to one. 

This command is equivalent to the following sequence of 
commands: 

REPORT-TERMINAL-SETTINGS: SO (returns open 

segment number) 
END-SEGMENT 

REPORT-GIN-POINT: -2 (returns current beam xy) 
REPORT-TERMINAL-SETTINGS: SP (returns current 

pivot point xy) 
REPORT-SEGMENT-STATUS: -2, X (returns default 

segment position xy) 
SET-PIVOT-POINT: (current beam xy) 
BEGIN-SEGMENT: (next lower segment ID) 
SET-PIVOT-POINT: (previous pivot point xy) 
SET-SEGMENT-POSITION: -2, (default segment 

position xy) 

The segment definition can be terminated by an END- 
SEGMENT command, a BEGIN-HIGHER-SEGMENT com- 
mand, a BEGIN-NEW-SEGMENT command, or another 
BEGIN-LOWER-SEGMENT command. 

When a segment created with this command is saved with 
the SAVE command, the segment definition is saved using 



the BEGIN-SEGMENT command instead of the BEGIN- 
LOWER-SEGMENT command, since all segments are the 
same once they are created. 



ERRORS 

SBOO (Level 0): 

SB00 (Level 2): 
SB01 (Level 2): 

SB02 (Level 3): 

SB03 (Level 2): 



Unrecognized command (the terminal 
firmware is version 1 or 2). 

The indicated segment already exists. 

Invalid value for next lower segment 
number (current segment ID is 1). 

Out of memory while ending or beginning 
segment definition. 

Context error; command is invalid at this 
time. No segment is current!" being 
defined, or a graphtext character is cur- 
rently being defined. 



REFERENCES 

BEGIN-HIGHER-SEGMENT command 
BEGIN-NEW-SEGMENT command 
BEGIN-SEGMENT command 
END-SEGMENT command 
REPORT-GIN-POINT command 
REPORT-SEGMENT-STATUS command 
REPORT-TERMINAL-SETTINGS command 
SET-PIVOT-POINT command 
SET-PICK-ID command 
SET-SEGMENT-POSITION command 
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BEGIN-NEW-SEGMENT Command 



Host Syntax 



E cSE intsegment-number 



Setup Syntax 



E cSE s p segment-number 



PARAMETERS 

segment-number (\ to 32767). 

The number of the segment being defined. 



DESCRIPTION 

This command begins the definition of a new graphic seg- 
ment with the specified segment identification number. 
If another segment is open, it is closed (as with an end- 
segment command). 

Valid segment numbers range from 1 to 32767. If a segment 
with the specified segment number already exists, or if the 
segment number used is invalid, an error is detected and 
reported. If a graphtext character definition is currently 
open, or a panel is being defined with no segment also 
being defined, an error is detected and the command is 
ignored. 

The pivot point and position of the new segment are set to 
the current beam position. The pick-ID is set to one. 



Issuing this command is equivalent to issuing the following 
sequence of commands: 

END-SEGMENT (if segment is currently open) 
REPORT-GIN-POINT: -2 (returns current beam xy) 
REPORT-TERMINAL-SETTINGS: SP (returns current 

pivot point xy) 
REPORT-SEGMENT-STATUS: -2, V (returns default 

segment position xy) 
SET-PIVOT-POINT: (Current beam xy) 
BEGIN-SEGMENT: segment-number 
SET-PIVOT-POINT: (Previous pivot point xy) 
SET-SEGMENT-POSITION: -2, (Default segment 

position xy) 

If there is no segment currently open, issuing this command 
is equivalent to issuing the above series of commands with- 
out the initial END-SEGMENT command. 

The segment definition can be terminated by an END- 
SEGMENT command, a BEGIN-HIGHER-SEGMENT com- 
mand, a BEGIN-LOWER-SEGMENT command, or another 
BEGIN-NEW-SEGMENT command. 
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When a segment created with this command is saved with 
the SAVE command, the segment definition is saved using 
the BEGIN-SEGMENT command instead of the BEGIN- 
NEW-SEGMENT command, since all segments are the 
same once they are created. 

DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — error 3E1 1 



REFERENCES 

BEGIN-HIGHER-SEGMENT command 
BEGIN-LOWER-SEGMENT command 
BEGIN-SEGMENT command 
END-SEGMENT command 
SET-PICK-ID command 
SET-PIVOT-POINT command 
SET-SEGMENT-POSITION command 
SET-SEGMENT-IMAGE-TRANSFORM command 



ERRORS 

SEOO (Level 0): 

SE02 (Level 3): 
SE03 (Level 2): 

SE10 (Level 2): 
SE1 1 (Level 2): 



Unrecognized command (the terminal 
firmware is version 1 or 2). 

Not enough memory to begin segment, or 
out of memory while defining segment. 

Command is invalid at this time (a 
graphtext character or a panel is currently 
being defined). 

Segment already exists. 

Invalid segment number (must be in the 
range from 1 to 32767). 
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BEGIN-PANEL-BOUNDARY Command 



4112,4113,4115 



Host Syntax 



E cLP xy.first-point \n\:draw-boundary 



Setup Syntax 



E cLP s p first-point draw-boundary 



PARAMETERS 

first-point (41 1 2, 41 1 3: X = to 4095, Y = to 4095; 
41 15: X = -2 31 to 2 31 -1 , Y = -2 31 to 2 31 -1 . 
The point on the display where the panel boundary 
begins and ends. 

draw-boundary (0 or 1). 

Determines whether the panel boundary will be drawn 
or not. 

not drawn (absent) 

1 drawn (present) 

DESCRIPTION 

This command begins the definition of a panel. A panel is a 
figure bounded by two or more vectors. If a panel will have 
two or more boundaries, the BEGIN-PANEL-BOUNDARY 
command is also used to begin the second and subsequent 
boundaries. 

The panel boundary begins and ends at the point specified 
by the first-point parameter. 

If the draw-boundary parameter is zero, the panel boundary 
is not drawn. If this parameter is 1 , then the boundary is 
drawn in the current line style and line index, as specified by 
the most recent SET-LINE-STYLE and SET-LINE-INDEX 
commands. 



Drawing the boundary. If the panel boundary is visible.it 
is drawn as the terminal receives the coordinates of the 
vertices of that boundary. The coordinates may be sent as 
part of MOVE, DRAW, and DRAW-MARKER commands. 

All parts of the boundary are drawn as vectors, even if the 
vertices were specified by MOVE or DRAW-MARKER com- 
mands. Markers are not drawn at the vertices of the bound- 
ary if they were specified by DRAW-MARKER commands. 

The panel boundary ends when an END-PANEL command 
or another BEGIN-PANEL-BOUNDARY command occurs. 
The panel boundary is closed, such that it ends where it 
began, that is, at the point specified by the BEGIN-PANEL- 
BOUNDARY command's first-point parameter. A panel is 
always a closed figure. 



Single-boundary panels. If a panel has a single boundary, 
the panel-definition has this syntax: 

panel-definition = BEGIN-PANEL-BOUNDARY 
[vertex...] 
END-PANEL 



where 



vertex = 



MOVE 
DRAW 
DRAW-MARKER 
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Figure 7-2 shows two panels, each with one boundary, in 
the first panel, the boundary does not intersect itself; in the 
second, it does. 



Points in the interior of a panel. When a panel boundary 
intersects itself (or when a panel has more than one bound- 
ary), it may not be not obvious what is meant by the "inte- 
rior" of a panel. The rule for determining which points are 
"inside" a panel is: 

• If, to get from "well outside the panel" (that is, from a 
point infinitely far away) to the point in question, one 
crosses the boundary(ies) an odd number of times, then 



that point is "inside" the panel. This rule holds regard- 
less of the route one follows to proceed from infinity to 
the point in question. 

• If, to get from "well outside the panel" (that is, "the point 
at infinity") to the point in question, one crosses the 
boundary an even number of times, then that point is 
"outside" the panel. 



Panels with multiple boundaries. To define a panel with 
more than one boundary, send more than one BEGIN- 
PANEL-BOUNDARY command within the panel-definition. 
Each such command begins a panel boundary. 
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Figure 7-2. Two Panels, Each With One Boundary. 
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BEGIN-PANEL-BOUNDARY commands after the first one 
terminate the previous panel boundary, while continuing to 
define the same panel. The full panel-definition syntax then 
becomes: 



panel-definition = 



panel-boundary-definition 

[panel-boundary-definition., 

END-PANEL 



where 



Filling the Interior. When the terminal receives the END- 
PANEL command, it fills the panel interior in the manner 
specified by the most recent SET-PANEL-FILLING-MODE 
command. If the SET-PANEL-FILLING-MODE command 
has specified that the panel is to be filled up to and includ- 
ing the boundary, then any visible boundary is covered over 
when the panel is filled. 

The fill pattern used is that specified by the most recent 
SELECT-FILL-PATTERN command. 



panel-boundary-definition = 



and 



vertex = 



BEGIN-PANEL- 
BOUNDARY 
[vertex...] 



( MOVE 1 

{ DRAW J 

I DRAW-MARKER J 



Text. Neither alphatext nor graphtext is permitted within a 
panel-definition. Graphtext within a panel-definition causes 
a type LT03 error. If the dialog area is enabled, any alpha- 
text received by the terminal during a panel-definition is 
sent to the dialog area, and does not interfere with the 
definition. If, however, the dialog area is not enabled, the 
receipt of alphatext causes a type LP03 error and the panel- 
definition is closed. 



Figure 7-3 shows two panels, each with multiple bounda- 
ries. Note that each boundary is a closed figure. The same 
"odd/even" rule as before defines the panel interior. 




vwy 
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Figure 7-3. Two Panels, Each With Multiple Boundaries. 
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DEFAULTS REFERENCES 

first-point END-PANEL command 

as shipped — none Panel-definition syntactic construct 

on power-up — • none SELECT-FILL-PATTERN command 

if omitted — (0,0) SET-PANEL-FILLING-MODE command 

draw-boundary-mode 
as shipped — none 
on power-up — none 
if omitted — 

ERRORS 

LP00 (Level 0): Unrecognized command (terminal is not 
a4112,4113,or4115). 

LP02 (Level 3): Out of memory while defining panel. 

LP03 (Level 2): Alphatext and graphtext is not allowed 

within a panel-definition. When this error 
is detected, the panel being defined is 
closed, as if an END-PANEL command 
had been received. 

LP11 (Level 2): \nva\\d first-point parameter (41 12, 4113: 
both X and Y range from to 4095; 41 15: 
X and Y both range from -2 31 to 2 31 -1 . 

LP21 (Level 2): Invalid draw-boundary parameter (must 
be or 1). 
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BEGIN-PIXEL-OPERATIONS Command 



4112,4113,4115 



Host Syntax 



E cRU mtsurface-number \n\--ALU-mode M:bits-per-pixel 



Setup Syntax 



e cRU s p surface-number ALU-mode bits-per-pixel 



PARAMETERS 



DESCRIPTION 



surface-number (4112: -1 to 3; 4113: -1 to4;4115:-1 to 8). 
Specifies the surface(s) on which subsequent pixel oper- 
ations will take place. 

-1 super surface (all bit planes of all surfaces). 

current surface. 

1 to 8 a specific surface. 

ALU-mode (41 12,41 13:0 to 16; 41 15:0, 7, 11, 12, 15, 
17,18). 
Arithmetic logic unit writing mode. The function that 
relates the current pixel to the pixel information intro- 
duced by subsequent pixel operations. means no 
change. 

bits-per-pixel (41 1 2: to 3, 6; 41 1 3: to 4, 6; 41 1 5: to 8). 
The number of bits in each pixel. Used for decoding 
subsequent RASTER-WRITE and RUNLENGTH-WRITE 
commands. 

current number of bits-per-pixel 

1 to 8 specific number of bits-per-pixel 



The BEGIN-PIXEL-OPERATIONS command sets three 
parameters for use by subsequent pixel operations com- 
mands. That is, commands that permit you to access 
directly the terminal's raster memory. RASTER-WRITE, 
RUNLENGTH-WRITE, RECTANGLE-FILL, PIXEL-COPY, 
and SAVE commands are pixel operations commands. Also, 
the parameters set by this command are used by the Option 
3A PX: pseudo device. 



Surface-number. The surface-number parameter specifies 
the surface on which subsequent pixel operations com- 
mands will write (or read) their data. For detailed informa- 
tion on surfaces, see Appendix D and the 4110 Series Host 
Programmer's Manual. 

A value of indicates that the existing surface is not to be 
changed. A value of -1 indicates that subsequent pixel 
operations occur on a "super surface" consisting of all bit 
planes in all surfaces. This super surface is for advanced 
applications. See Appendix D for details on the super sur- 
face and its side effects. 



7-20 



41 10 SERIES COMMAND REFERENCE 



TEK COMMANDS 



ALU-mode. The ALU-mode parameter is an integer in the 
range from to 1 8. Modes through 1 6 are valid for 41 1 2 
and 41 13 terminals. Modes 0,7, 11, 12, 15, 17 and 18 are 
valid for 41 15 terminals. A value of indicates that the exist- 
ing ALU-mode is not to be changed. Values from 1 to 18 
specify how RASTER-WRITE, RUN LENGTH-WRITE, 
RECTANGLE-FILL, and PIXEL-COPY commands modify 
the existing contents of the terminal's raster memory buffer. 

At each pixel position in raster memory space, the color 
index being written is regarded as a binary number and is 
combined, bit by bit, with the color index already stored at 
that pixel location. The result is a new color index, which is 
stored at that pixel location in the raster memory buffer. 

Let A be one of the bits in the color index currently stored at 
a particular pixel location in raster memory space. Let B be 
the corresponding bit in the color index being supplied by 
the RASTER-WRiTE, RUNLENGTH-WRITE, RECTANGLE- 
FILL, or PIXEL-COPY command. Let W be the correspond- 
ing bit of the coior index which the terminal's ALUs (arith- 
metic logic units) actually write into that pixel location in 
raster memory space. Then W is some function of A and B: 

W = f(A,B) 

The ALU-mode parameter selects the function f from 
among sixteen possible functions of A and B: f 1 (A,B) to 
f16(A,B). Table 7-1 lists the function fN selected by selected 
by each value N of the ALU mode parameter. In the table, bit 
A is the bit already stored in the raster memory buffer; bit B 
is the bit supplied by the RASTER-WRITE, RUNLENGTH- 
WRITE, RECTANGLE-FILL, or PIXEL-COPY command, and 
bit W is the resulting bit which is actually written into the 
raster memory buffer. 

Modes 1 7 and 1 8 are available only on the 41 1 5. Rather 
than operating bit by bit, these modes operate on all bits of 
the pixel surface. For instance, for Mode 17 and an eight-bit 
pixel surface, if A = 5 (binary 00000101) and B = 3 (binary 
00000011), then A + B = 8 (binary 00001 000). For an n-bit 
pixel surface, the addition or subtraction (Modes 17 or 18, 
respectively) is done in modulo 2**n arithmetic. Thus, on a 
4-bit surface, 15 + 15 = 1 4. 



Table 7-1 
ALU VALUES TABLE 



ALU-mode 


W = f(A,B) 





no change 


1 


not A 


2 


not (A or B) 


3 


(not A) and B 


4 





5 


not (A and B) 


6 


notB 


7 


AXORB 


8 


A and (not B) 


9 


(not A) or B 


10 


not (AXORB) 


11 


B 


12 


AandB 


13 


1 


14 


A or (not B) 


15 


AorB 


16 


A 


17 


A + B 


18 


A - B 



Of the values in Table 7-1 , the following are particularly 
useful: 

Mode W = f(A,B) Use 

I not A This yields a reverse video: best used 

with the RECTANGLE-FILL command 
(not available on a 41 1 5). 

7 A XOR B This provides an opportunity to write an 

image which can later be completely 
removed without trace by repeating the 
same operation. That is because A = (A 
XOR B) XOR B. 

II B This is the default y4Z,[/-ffjocfe. This 

causes a complete replacement of 
the existing image with the new 
pixels. 

15 A or B This is an "overstrike mode," in 

which the new image is written on 
top of the existing image. Zero pixel 
values in the command string do 
not affect the pixel buffer. 
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Bits-per-pixel. The bits-per-pixel parameter is used to 
decode subsequent RASTER-WRITE and RUNLENGTH- 
WRITE commands. It is also used by subsequent SAVE 
commands when saving a stream of RASTER-WRITE and 
RUNLENGTH-WRITE commands. Seethe descriptions of 
the RASTER-WRITE, RUNLENGTH-WRITE, and SAVE 
commands for details. 

In the 41 1 2, bits-per-pixel may be 0, 1 , 2, 3, or 6. In the 
41 1 3, valid values are 0, 1 , 2, 3, 4, and 6. In the 41 15, valid 
values are through 8. A value of indicates that the exist- 
ing bits-per-pixel encoding mode is not to be changed. 
Normally, bits-per-pixel would be set equal to the number of 
bit planes used by the surface being selected. In the 41 1 2 
and 41 13, if you specify six bits per pixel, the top three 
(41 1 2) or two (4113) bits are ignored. 

If the surface-number parameter specifies a surface which 
has fewer bit planes than the number in the bits-per-pixel 
parameter, The least significant (low-order) bits are ignored 
in indices written on that surface. 



DEFAULTS 

surface-number 
as shipped — 1 
on power-up — 1 
if omitted — unchanged 

ALU-mode 

as shipped — 1 1 

on power-up — 1 1 

if omitted — unchanged 

bit-per-pixel 
as shipped — 6 
on power-up — 6 
if omitted — unchanged 



ERRORS 

RU00 (Level 0): 

RU10 (Level 2): 

RU11 (Level 2): 
RU21 (Level 2): 
RU31 (Level 2): 

REFERENCES 



Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

Surface does not exist (has not been 
defined with a SET-SURFACE- 
DEFINITIONS command). 

Invalid surface-number. (41 1 2: -1 to 3; 
41 13: -1 to 4; 4115: -1 to 8.) 

Invalid ALU-mode. (41 12, 41 13: to 16; 
4115:0,7, 11,12, 15, 17, or 18.) 

Invalid bits-per-pixel. (41 12:0,1,2, 3, or 
6; 41 13: 0,1, 2, 3, 4, or 6; 41 15:0 to 8.) 



PIXEL-COPY command 
RASTER-WRITE command 
RECTANGLE-FILL command 
RUNLENGTH-WRITE command 
SAVE command 
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Host Syntax 



E cSO \vX\segment-number 



Setup Syntax 



E cSO s p segment-number 



PARAMETERS 

segment-number (1 to 32767). 

Number of segment to be defined. 



DESCRIPTION 

This command begins the definition of a new segment with 
the specified segment identification number, and resets the 
current pick-ID to one. 

Valid segment-numbers are 1 to 32767. If a segment with the 
specified segment number already exists, or if the segment 
number used is invalid, an error will be generated and 
reported. If another segment, graphtext character, or panel 



jnusr 



y uciii imOi i 19 Vsui i ci my upci i 



and the command is ignored. 



Pivot Point 



The segment will be defined with its pivot point at the loca- 
tion specified by the most recent SET-PIVOT-POINT com- 
mand. (See the description of the SET-PIVOT-POINT 



command iOf details.) The pivot point is 3ii Unchangeable 
attribute of a segment; therefore, if the segment's pivot 
point is to be different from that previously defined, it is 
important to issue an appropriate SET-PIVOT-POINT com- 
mand before issuing the BEGIN-SEGMENT command. 



Terminating the Segment Definition 

A segment definition can be terminated by an END- 
SEGMENT, BEGIN-HIGHER-SEGMENT, BEGIN-LOWER- 
SEGMENT, or BEGIN-NEW-SEGMENT command. The 
segment is saved in RAM. Saving on the disk requires a 
SAVE command. 



Graphic Primitives 

Within a segment definition (between the BEGIN- 
SEGMENT and the BEGIN-HIGHER-SEGMENT, BEGIN- 
LOWER-SEGMENT, BEGIN-NEW-SEGMENT, or END- 
SEGMENT commands), there may be graphic primitives: 
vectors, markers, graphic-text commands, panel- 
definitions, and sometimes alpha text. If the dialog area is 
not enabled, then alphatext is deemed to be a graphic primi- 
tive and is included in the segment being defined. 
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When a segment is being defined and the dialog area is 
disabled, the "wrap-around" features of alphatext are dis- 
abled. When the next character to be displayed would end 
past x = 4095 on a 41 1 2, 41 1 3, 41 1 4, or 41 1 6, or the right 
boundary of the 41 1 5 overview window. It is not displayed 
and the alpha cursor is not changed. Similarly, a (BS) char- 
acter is not processed if the resulting x-position would be 
less than zero or the left boundary of the 41 15 overview 
window. Likewise, a l f character is not processed if the 
resulting y-position would be less than zero, or the bottom of 
the 41 1 5 overview window, and a (VT) character is not proc- 
essed if the resulting y-coordinate would be greater than 
3071 on a 41 12, 41 13, 41 14, or 41 15, or the 41 15 Home 
position. 

Primitive Attributes 

Also included in a segment definition are primitive attributes 
commands which change attributes of graphic primitives. 
Examples of these would be SET-LINE-STYLE, SET- 
MARKER-TYPE, and SET-GRAPHTEXT-ROTATION. 



INCLUDE-COPY-OF-SEGMENT Command 

Besides graphic primitives, a segment definition may also 
have include-copy-of-segment commands. When such a 
command occurs, the segment it references is copied into 
the segment being defined. (The segment, as transformed 
by its current image transform, is copied into the segment 
being defined. That is, the segment is after being scaled, 
rotated, and positioned in accordance with that segment's 
current image transform. See the SET-SEGMENT- 
POSITION and SET-SEGMENT-IMAGE-TRANSFORM 
commands for details.) 



Syntax of Segment-Definition 

A segment definition usually follows this syntax: 

segment-definition = BEGIN-SEGMENT 
[part-of-segment...] 
END-SEGMENT 



C MOVE 

DRAW 

DRAW-MARKER 

G sxyxy... 

F sxyxy... 

SET-LINE-STYLE 

SET-LINE-INDEX 

SET-MARKER-TYPE 

GRAPHIC-TEXT 

SET-TEXT-INDEX 

SET-GRAPHTEXT-FONT 

SET-GRAPHTEXT- 
PRECISION 

SET-GRAPHTEXT-ROTATION 

SET-GRAPHTEXT-SIZE 

INCLUDE-COPY-OF- 
SEGMENT 
Lalphatext-graphic-primitive 



part-of-segment = 



alphatext-graphic-primitive = 



any text sent to the 
terminal with the 
terminal in alpha 
mode and with the 
dialog being disabled. 



Any printable text which is sent to the terminal while the 
terminal is in alpha mode and the dialog area is disabled wil! 
be stored in the segment. (This is the alphatext-graphic- 
primitive mentioned above.) In such text, the special char- 
acters h t, B s, (VT), l f, and c r are stored in the segment as 
moves to the appropriate xy positions. (Since these charac- 
ters are stored as moves, they are scaled by any SET- 
SEGMENT-IMAGE-TRANSFORM commands. In the 41 12 , 
41 13, and 41 1 5, they are scaled according to the current 
window-viewport transform.) 
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The View In Which A Segment Is Made Visible 

In the 41 12, 41 13, and 41 15 terminals, a segment is made 
visible in the view which is selected at the time of the END- 
SEGMENT command that terminates the segment defini- 
tion, unless a SET-SEGMENT-VISIBILITY command for 
"segment -2" has determined that newly-created segments 
are to be invisible. 

If you issue a SELECT-VIEW command during a segment 
definition, the segment is made visible only in the view 
which is selected at the time the segment is closed. To make 
a segment visible in all views, select each view and issue a 
SET-SEGMENT-VISIBILITY command tor segment-number 
= -2 for each view. This makes all future segments visible 
in each view. 



DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — error S01 1 



ERRORS 

5002 (LeveiS): Not enough memory to begin segment, or 

out of memory while defining segment. 

5003 (Level 2): Command is invalid at this time. (Another 

segment, a graphtext character, or a 
panel is currently being defined.) 

5010 (Level 2): Segment already exists. 

501 1 (Level 2): Invalid segment-number (must range from 

1 to 32767). 



REFERENCES 

BEGIN-HIGHER-SEGMENT command 
BEGIN-LOWER-SEGMENT command 
BEGIN-NEW-SEGMENT command 
END-SEGMENT command 
INCLUDE-COPY-OF-SEGMENT command 
SELECT-ViEW command 
SET-PICK-ID command 
SET-PIVOT-POINT command 
SET-SEGMENT-IMAGE-TRANSFORM command 
SET-SEGMENT-POSITION command 
SET-SEGMENT-VISIBILITY command 
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b l Character 

DESCRIPTION REFERENCES 

When a terminal receives a b l character it sounds its bell. ENTER-VECTOR-MODE command 

A b l in Vector mode sets the move/draw flag to draw, so that 
g s b l xy causes a vector to be drawn from the current posi- 
tion to the specifed xy coordinate. 
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Block Syntactic Construct 



OPTION 01 



SYNTAX 



block = \block-"other-than-last"-line...\ 
block-last-line 

block-"other-than-last"-line = block-header 

packed-data 
block-continue-char 
EGL-string 

block-last-line = block-header 
packed-data 
block-end-char 
EOL-string 



Parts of a Block 

block-header. 

A sequence of up to ten characters, set by the SET- 
BLOCK-HEADERS command. 

packed-data. 

Characters of packed data, the result of applying the 
packing algorithm selected by the SET-BLOCK- 
PACKING command. 

block-continue-char. 

An ASCII character, selected by the SET-BLOCK- 
CONTINUE-CHARS command. 

block-end-char. 

An ASCII character, selected by the SET-BLOCK-END- 
CHARS command. 

EOL-string. 

A sequence of up to two characters, determined by the 
SET-EOL-STRING command. 



DESCRIPTION 

In block mode, each block sent to or from the terminal has 
the syntax described above. Each "line" of a block starts 
with a block-header, which is defined by the SET-BLOCK- 
HEADERS command. The end of each line is signalled by a 
block-continue-char (if it is not the last line in the block), or 
by a block-end-char (for the last line of the block). 

Between the block header and the block-continue-char or 
block-end-char is a sequence of ASCII characters which 
hold the data being sent in a "packed" format; these char- 
acters comprise the packed-data. None of these characters 
may be the same as the characters reserved as the block- 
continue-char and block-end-char. The packing scheme 
is described together with the SET-BLOCK-PACKING 
command, elsewhere in this section. 

The EOM-character (usually a c r) from the keyboard, which 
terminates a terminal-to-host block, is included in the block 
as the last data character. 

The block-header, block-continue-char, block-end-char, and 
the block packing scheme may be different for blocks sent 
from the terminal to the host than for blocks which the termi- 
nal receives from the host. These parameters are set with 
the SET-BLOCK-HEADERS, SET-BLOCK-CONTINUE- 
CHARS, SET-BLOCK-END-CHARS, and SET-BLOCK- 
PACKING commands. 
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For blocks sent from the terminal to the host computer, the 
EOL-string is the current "end of line string," set by the 
SET-EOL-STRING command. (Typically, this is c r or c r u f.) 

For blocks sent from the host computer to the terminal, the 
EOL-string consists of any characters which the host may 
send after the block-continue-char or block-end-char and 
before the block-header that starts the next block. All such 
characters are ignored by the terminal until (and unless) a 
printable character — ADE 32 to 162 — is encountered. 

When the terminal detects the printable character it does a 
carriage return and prints the detected character and all fol- 
lowing text (as unescorted text) until the next block header 
is detected. 



REFERENCES 

Block-control-bytes syntactic construct 
SET-BLOCK-CONTINUE-CHARS command 
SET-BLOCK-END-CHARS command 
SET-BLOCK-HEADERS command 
SET-BLOCK-LENGTH command 
SET-BLOCK-MASTER-CHARS command 
SET-BLOCK-NON-XMT-CHARS command 
SET-BLOCK-PACKING command 
SET-BLOCK-TIMEOUT command. 
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BLOCK-CONTROL-BYTES Syntactic Construct 



OPTION 01 



SYNTAX 



block-control-bytes = 



control-byte-1 
control-byte-2 
control-byte-3 
control-byte-4 



DESCRIPTION 

In block mode, when the terminal or host composes a block 
to be sent over the data communications line, it appends 
four block-control-bytes to the characters or other data 
being packed into the block. 

The four control bytes are packed into the block along with 
the other unpacked data; see the description of the SET- 
BLOCK-PACKING command for details. If the unpacked- 
byte-size (as set by the SET-BLOCK-PACKING command) is 
seven, then each control byte consists of seven binary bits. 
If the unpacked byte size is eight, then each control byte 
consists of eight binary bits. 



Control-Byte-1 

Let bit 1 be the least-significant bit of the byte; then bit 7 or 
bit 8 is the most-significant bit of the byte. (Bit 7 is the most- 
significant bit if the "unpacked byte size" is seven, since in 
that case there is no bit 8.) The individual bits are assigned 
as follows: 

Bits 1 and 2: Block count and end-protocol. 

Bits 3, 4, 5: Reserved (always zero) 

Bit 6: End of file 

Bit 7: End of message 

Bit 8: Unused (not present in 7-bit bytes; always 

zero in 8-bit bytes) 

In control-byte-1 , bits 1 and 2 together serve two functions: 
they determine whether the terminal is to exit block mode, 
and — while the terminal is in block mode — they maintain 
an "odd/even" modulo two counter of blocks sent over the 
data communications line. Table 7-2 lists the four possible 
states of these bits, together with their meanings. 



Table 7-2 
MEANINGS OF LOW-ORDER BITS IN CONTROL-BYTE-1 



Bit 2 


Bit 1 


Meaning 








This is an "even" biock; the terminal remains in biock 
mode. 





1 


This is an "odd" block; the terminal remains in block 
mode. 


1 





In a block sent from the host to the terminal, this bit 
pattern acts as a command to the terminal to exit from 
block mode, but remain armed for block mode, and 
before exiting block mode, to acknowledge this 
command by sending an 'ACK' block to the host." 

In a block sent from the terminal to the host, this bit 
pattern means, "This is an 'ACK' block 
acknowledging receipt of a command to exit block 
mode. The terminal is now leaving block mode, but 
will remain armed for block mode." 


1 


1 


In a block sent from the host to the terminal, these two 
bits comprise a command to the terminal: "Exit from 
block mode, but remain armed for block mode. Exit 
block mode immediately; do not send an 'ACK' block 
to the host." 

In a block sent from the terminal to the host, this 
combination of bits is not allowed. 



Bit 6, the end-of-file bit, is set to one at the end of a file trans- 
fer; setting this bit serves the same purpose as the EOF- 
string used when the terminal is not in block mode. 

In blocks which the terminal sends to the host, bit 7, the 
end-of-message bit, when set to one, indicates that the 
terminal has terminated the block because it encountered 
an EOM-char or EOM-indicator in the data being sent. 
When set to zero, this bit indicates that the block was termi- 
nated only because the maximum block length was 
reached, and that another block follows which contains 
more of the same message. 
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In blocks sent from the host to the terminal, bit 7 has a dif- 
ferent meaning. If the bit is zero, the terminal is requested to 
acknowledge the block immediately (by sending an ACK 
block in reply). The terminal sends the ACK block imme- 
diately, whether or not it has a message to pack into that 
block. (The ACK block contains only the four block con- 
trol bytes.) 

If, however, the host sets bit seven to one, then the terminal 
does not acknowledge the block immediately. Instead, it 
waits until it has a block full of data to send, or until it 
encounters an EOM-char or EOM-indicator in the data 
it has to send to the host. 

When sending a block to the terminal, the host should set 
bit 7 to zero, except when it expects a response message 
from the terminal. If a response message is expected, the 
host should set bit 7 to one. 



Control-Byte-2 

All the bits of control byte 2 are reserved; they are always 
zero. 



BEGIN 

L : = L + Byte; 

IF (L > MaxByte) THEN L : = L - MaxByte 
END 

3. As each byte is added to L, the new value of L is added 
to H. The same "end-around-carry" method is used: 

BEGIN 

H : = H + L; 

IF (H > MaxByte) THEN H : = H - MaxByte 
END 

4. When steps 2 and 3 have been performed for each 
of the unpacked bytes preceding the check code 
bytes, then the two check code bytes are computed 
as follows: 

BEGIN 

C1 := MaxByte-H-L; 

IF(C1 < 1)THENC1 := C1 + MaxByte; 

Control Byte3 : = C1 ; 

Control Byte4 : = H 
END 



Control-Byte-3 and Control-Byte-4 

The last two control bytes carry a "check code" by which 
the receiving device (the terminal or the host computer) can 
verify that it has received the block with no errors. The 
check code is derived from all the unpacked data bytes 
which precede it : plus the first two control bytes. The proc- 
ess is as follows: 

1 . Two "checksum bytes" — called H and L for this expla- 
nation — are both set equal to MaxByte. Here, Max- 
Byte is 1 27 (for 7-bit bytes) or 255 (for 8-bit bytes). 

2. Each byte in the preceding unpacked data is regarded 
as a binary numeral and added to L. The sum is com- 
puted as with "modulo 7 (or modulo 8) end-around- 
carry." That is, for a 7-bit "unpacked byte size," 
whenever the sum exceeds the maximum 7-bit numeral 
(1 27), the "carry" bit is omitted and one is added to 
the least-significant bit of the sum. Likewise, if the 
unpacked byte size is 8-bits, then whenever the sum 
exceeds 255, the carry bit is omitted and one is added 
to the least-significant bit of the sum. 

This process is equivalent to the following algorithm, in 
which MaxByte = 1 27 (for 7-bit bytes) or 255 (for 8-bit 
bytes): 



Packing the Control Bytes into the Block 

When all four control bytes have been computed, they are 
packed into the block along with any other unpacked data 
bytes; see the description of the set-block-packing com- 
mand for details. 



Checking a Received Block 

When a block is received and unpacked, the H and L check- 
sum bytes are computed as described above. As each byte 
is unpacked, the "unpacked byte" is added to L (with end- 
around carry), and L is added to H (with end-around carry). 
This is done on all bytes as they are unpacked, including all 
four control bytes. When the block-end-char is detected, H 
and L should both equal MaxByte. That is, if the unpacked 
bytes are 7-bit bytes, then H = L = 127; if they are 8-bit 
bytes, H = L = 255. If this is not the case, then a data trans- 
mission error has occurred. (In that case, the terminal or the 
host receiving the block would re-transmit the last block it 
had sent.) 



REFERENCES 

SET-BLOCK-PACKING command 
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BORDER Key 4112,4113,4115 

DESCRIPTION REFERENCES 

This key exists only on the 41 12, 41 13, and 41 15 terminals. SET-BORDER-VISIBILITY Command 

It does not auto-repeat. 

Pressing the BORDER key (SHIFT-NEXTVIEW) changes 
the border visibility in the current view, if the border was not 
visible, it becomes visible, and if the border was visible, it 
becomes invisible. 
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BREAK Key 



DESCRIPTION 

Pressing the BREAK key sends a "break" signal to the host. 
(In some time-sharing systems, the "break" signal is a way 
for the terminal operator to interrupt the host computer and 
request the use of the communications line. However, many 
time-sharing systems do not recognize "breaks.") 

If the keyboard is locked, pressing BREAK also unlocks the 
keyboard. (This can also be accomplished by pressing 
CANCEL.) 

For most host systems, the break signal should last for 200 
milliseconds; that is the "default" setting to which this 
parameter is set when the terminal is shipped from the 
factory. However, this duration may be changed with the set- 
break-time command. (Indeed, by setting the break time to 
zero, the BREAK key can be disabled; this can be useful if 
the host computer does not tolerate "break" signals.) 

If your terminal has Option 4K (the Katakana keyboard) 
installed, pressing this key causes the ASCII font to be- 
come active. 



Full Duplex Mode 

In full duplex mode, the break signal consists of a "space" 
condition sent on the TDATA line at the RS-232 connector. 



Half Duplex Modes 

In "half duplex normal," "half duplex with automatic 
request to send," and "half duplex with supervisor" modes, 
the the terminal responds to BREAK by turning off the 
SRTS (Secondary Request To Send) signal. This is a s! n nal 
at the RS-232 interface between the terminal and its modem 
or other data communications equipment. If the modem 
uses the SRTS signal, then the modem turns off the sec- 
ondary carrier. The host may or may not respond to the 
absence of secondary carrier by releasing the communica- 
tions line so that the terminal may use it to transmit a mes- 
sage to the host. 



REFERENCES 

SET-BREAK-TIME command 
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These paragraphs describe the four uses of the B s 
character. 



DESCRIPTION 

4114 and 41 1 6 Alpha Mode, 
Dialog Area Disabled 

In the 41 1 4 and 41 1 6, if the dialog area is not enabled 
(enable-dialog-area : 0), then the alpha cursor marks a 
particular location on the screen. In that case, a B s charac- 
ter moves the alpha cursor one character position to the left 
on the screen. 

If the cursor is already at the current margin, and no seg- 
ment is currently begin defined, then B s moves the cursor to 
the right end of the same line. Here, "same line" means 
"same logical line" — everything up to the c r l f. If wrap- 
around has occurred, this may not be the same thing as the 
same "physical line" displayed on the screen. 

If the cursor is already at the current margin, and a segment 
is currently being defined, then B s has no effect. 

41 1 2, 41 1 3, or 41 1 5 Alpha Mode, 
Dialog Area Disabled 

in the 41 1 2, 41 1 3, or 41 1 5, if the dialog area is not enabled 
(ENABLE-DIALOG-AREA : 0), then the alpha cursor marks 
a particular location in terminal space or the 41 15 overview 
window. In that case, a B s character moves the alpha cursor 
one character position to the left in terminal space or the 

41 15 overview window. Here, "one character position to the 
left" means a distance to the left in terminal space or the 
4115 overview window which corresponds to the spacing 
between adjacent characters in the current viewport in 
raster memory space. If this new position in terminal space 
or the 41 1 5 overview window falls outside the current win- 
dow, then the alpha cursor is not visible. 



If the alpha cursor is already at the left edge of terminal 
space or the 41 1 5 overview window, and no segment is 
being defined, then B s moves the alpha cursor to the right 
end of the same line in terminal space or the 41 1 5 overview 
window. (That is, the alpha cursor moves to the right edge of 
terminal space or the 41 1 5 overview window, but the y- 
coordinate of the cursor does not change.) 

If the alpha cursor is at the left edge of terminal space or the 
41 15 overview window, and a segment is currently being 
defined, then the B s character has no effect. 



All Terminals Alpha Mode, Dialog Area Enabled 

If tha Hialrw-i aroa ie anohlaH {anaY\la-fi\alrtn-araa * "M anH tho 

terminal is in alpha mode, then the alpha cursor marks a 
particular location in the dialog area scroll, in that case, a B s 
character moves the cursor one character position to the 
left in that scroll. If the cursor is already at the left end of that 
line in the dialog area, then B s has no effect. 



Vector and Marker Modes 

If the terminal is in vector mode or marker mode, then the 
B s character has no effect. 



REFERENCES 

ENABLE-DIALOG-AREA command 
ENTER-ALPHA-MODE command 
ENTER-MARKER-MODE command 
ENTER-VECTOR-MODE command 
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Bypass-Cancel-Char 

DESCRIPTION REFERENCES 

The bypass-cancel-char is a character which, when received ENTER-BYPASS-MODE command 

by the terminal, removes the terminal from bypass mode. It SET-BYPASS-CANCEL-CHAR command 

is set by the SET-BYPASS-CANCEL-CHAR command. 

For more information, see the descriptions of the ENTER- 
BYPASS-MODE and SET-BYPASS-CANCEL-CHAR 
commands. 
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CANCEL Command 



Host Syntax 




Setup Syntax 




DESCRIPTION 

This command resets to default values a number of terminal 
parameters and modes: 

• Puts the terminal in Alpha mode. (Removes it from 
Vector or Marker mode. 

• Selects the standard alphatext font. (See SET-ALPHA- 
TE)CT-FONT command.) 

• Removes the terminal from GIN mode as if a command 
to disable all GIN was received. (See ENABLE-GIN and 
DISABLE-GIN commands.) 

• Unlocks the keyboard. (See LOCK-KEYBOARD 
command.) 

• Cancels bypass mode. (See ENTER-BYPASS-MODE 
command.) 

• Flushes input/output queues. (See SET-QUEUE-SIZE 
command.) Characters not yet sent to the host will be 
discarded and ignored. 



• Removes the terminal from prompt mode. (See 
PROMPT-MODE command.) 

• Halts segment operations being done to segments speci- 
fied by segment-numbers -1 and -3. 

• Cancels Snoopy mode when issued from Setup mode. 

REFERENCES 

CANCEL Key 
DISABLE-GIN command 
ENABLE-GIN command 
LOCK-KEYBOARD command 
PROMPT-MODE command 
SET-ALPHATEXT-FONT command 
SET-QUEUE-SIZE command 
SET-SNOOPY-MODE command 
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CANCEL Key 

DESCRIPTION 

The CANCEL key (the SHIFTed version of the LOCAL key) 
performs all the functions of the CANCEL command, and 
causes an exit from Snoopy mode (see the SET-SNOOPY- 
MODE command description). 

Pressing this key also performs the following functions that 
are not accomplished by the CANCEL command: 

• Aborts any file transfer (except spooling) in progress. 

• Aborts any color hardcopy in progress on a 41 1 3 or 41 15 
terminal witn Option 9 installed. 

• Aborts any DMA transfers in progress on a 41 15 terminal 
with Option 3A installed. 



• Terminates any panel-filling operation resulting from a 
PAGE or RENEW-VIEW command on the 41 12, and 
41 13 terminals. 

The CANCEL key does not auto-repeat. 



REFERENCES 

CANCEL command 
PAGE command 
RENEW-VIEW command 
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Char Parameter Type 

SYNTAX 



char = a "printing" ASCII character, that is, an ASCII character with ASCII Decimal Equivalent (ADE) ranging 
from 32 to 126. 



REFERENCES 

Char-report message type 
String parameter type 
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Char-Report Message Type 



SYNTAX 



char-report = [EOM-indicator] 
ASCII-char 

ASCII-char = (any ASCII character) 



DESCRIPTION 

When the terminal reports the value of a char parameter to 
the host computer, it sends that report using the char-report 
syntax. This consists of an optional EOM-indicator, fol- 
lowed by the char parameter being reported. 

The char-report message type is also used to report ASCII 
characters which are not valid char parameters: characters 
with decimal equivalents outside the range from 32 to 126. 

The EOM-indicator is rarely included in the char-report. 
The terminal only sends the EOM-indicator if there is no 
other way to avoid exceeding the maximum line length. 

For instance, during graphic input for the locator function 
and thumbwheels device, the GIN-locator-report includes a 
char-report. That char-report tells the host which key was 
pressed by the operator to initiate the GIN-locator-report. 
Since the operator can type any ASCII character to initiate a 
GIN-locator-report, it is possible for any ASCII character to 
occur in a char-report. 



The EOM-indicator is only sent as part of a char-report if 



K*-i+W tKri frtlirti* 



ii-lif irnoo nrey rryrsf' 



• The terminal has already sent at least one character on 
the current line. (That is, it has already sent at least one 
character since the last EOM-char or EOM-indicator.) 

• If the EOM-indicator were not to be sent, then sending 
the ASCII-char character would cause the maximum line 
length to be exceeded. 

Because char-reports are always parts of larger messages 
which the terminal sends the host the second condition is 
seldom met. (For usual settings of the maximum line length, 
the syntax of the larger report message will guarantee that 
the maximum line length is not exceeded.) 

However, if the maximum line length is set too short, or if a 
"line" of the report message being sent to the host is too 
long, then it is possible that optional EOM-indicators in the 
syntax of the larger report would not cause the line to termi- 
nate soon enough. Only in that case would the optional 
EOM-indicator in the char-report syntax come into play. 



EOM-indicator 

The optional EOM-indicator occurs in the char-report syn- 
tax because of the terminal's "maximum line length" fea- 
ture for messages sent to the host computer. This 
EOM-indicator is rarely, if ever, sent. 



REFERENCES 

Array-report message types 
Char parameter type 
GIN-report-sequence message type 
GIN-locator-report syntactic construct 
GIN-pick-report syntactic construct 
GIN-stroke-report syntactic construct 
Port-status-report message type 
Segment-status-report message type 
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CLEAR Key 

DESCRIPTION REFERENCES 

The CLEAR key (the SHIFTed version of the DIALOG key) CLEAR-DIALOG-SCROLL command, 

has the same effect as the CLEAR-DIALOG-SCROLL com- 
mand: it erases the dialog area scroll. 

The CLEAR key does not auto-repeat. 
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CLEAR-DIALOG-SCROLL Command 
Host Syntax 




Setup Syntax 




DESCRIPTION REFERENCES 

Erases (clears) the dialog area scroll buffer. The cursor is CLEAR key. 

positioned at the top left of the dialog scroll buffer. 
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Colorhardcopy-Status-Report Message Type 



OPTION 9 



SYNTAX 



colorhardcopy-status-report = 



[sig-char] 

char-report: Q 

char-report: Q 

int-report: device-characteristics 

int-report: device-ID 

mt-report.copier-version-and-option-number 

int-report: long-axis-device-addressability 

int-report: short-axis-device-addressability 

int-report: copies-in-queue 

int-report: error-code 

EOM-indicator 



DESCRIPTION 

This report is sent by the terminal in response to a REPORT- 
COLORHARDCOPY-STATUS command. 



Device Characteristics 

A 1 6-bit integer. The individual bits have the following 
meanings: 

B15 B14 B13 B12 B11 B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 BO 
X X X X X X XXSSS MTCPPAPAIM 

X = Reserved for future use. 
S = Media size; these th ree bits specify the size of the 
media loaded into the copier: 



CP = copy process 



MT = 



B7 B6 B5 


Media Size 








A— 8.5" x 11" 





1 


B— 11" x 17" ENGLISH 








C— 17" x 22" 








D — 22" x 34" 


1 





A4 — 297 x 210mm 


1 


1 


A3 — 420 x 297 mm METRIC 


1 1 





A2 — 594 x 420 mm 


1 1 


1 


A1 — 840 x 594 mm 


media type 







Paper 




1 


Transparency 



PA = 



Noninterruptible 

1 Interruptlble 

number of passes (a copier specification). Add 
1 to the value of the two-bit field (B2 and B1). 



IM = imaging/media relationship 

Image parallel to short axis of media 

1 Image parallel to long axis of media 



Device-ID 

An integer that identifies the model of color copier. Possible 
values include "4691". 



Copier-version-and-option-number 

A four digit integer that, when interpreted hexidecimally, 
identifies the copier version and option number. The first 
two digits represent the copier version, and the last two dig- 
its represent the option number. For example, if the integer 
returned is " 1 000H", then the version number is 1 .0, and 
the option number is 0.0 (i.e., no options installed). 
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Long-axis-device-addressability 

An integer that specifies the maximum pixels the image 
contains in the direction of the long axis. 



Short-axis-device-addressability 

An integer that specifies the maximum pixels the image 
contains in the direction of the short axis. 



Copies in queue 

The number of copies requested from the copier but not yet 
copied. The range of this report is G through 55535. 



Error code 

A 16-bit integer. The individual bits have the following mean- 
ings when set to one: 

B15 B14 B13 B12 B11 B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 BO 
X X X X X LC BPBCTOCSIP ECDCFEMJOC 

X = Reserved for future use. 

LC = Line count error: error in number of lines transmitted 

per copy. 
BP = Bit prompt error: error in number of bit prompts sent 

in status message. 
BC = Byte count error: error in number of bytes sent in 

Raster Data Transmission. 
TO = Time out error: idle time exceeded. 
CS = Checksum error: command preamble data string in 

error. 
IP = Inconsistent preamble data. 
EC = Unexpected command. 
DC = Undefined command. 
FE = Fatal device error. 
MJ = Media jam. 
OC = Out of consumables: i.e., media, toner, ink, etc. 



REFERENCES 

REPORT-COLORHARDCOPY-STATUS command 
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COPY Command 



Host Syntax 




Setup Syntax 



COPY s p source TO destination 



PARAMETERS 

source. 

Specifies the source of the data being copied. Valid spe- 
cifiers (depending on options installed) are: 



HO: 

FO:filename 
filename 



the host computer 
a disk file 



F1 
SO 
Z7 

FO 
F1 
SO 

PO 
P1 
P2 

SC 

DM 

SG 
PX: 
CM 



filename 
filename — 
filename 



— Z7: 



all files on an entire disk drive 



an RS-232 peripheral port 

the Option 9 screen pseudo device 

the DMA interface 

Option 3A (DMA) psuedo-devices 



separator. 

Must be the empty string or TO. In Setup mode, must be 
TO. 

destination. 

Names the destination for the data being copied. Valid 
specifiers (depending on options installed) are: 



HO: 


the host computer 


FO:filename 


a disk file 


filename 




F1 filename 




SO:filename - 




Z7:filename 




FO: 


same files as source 


F1: 




SO:— Z7: 




PO: 


an RS-232 peripheral port 


P1: 




P2: 




HC: 


the color hardcopy interface 


DM: 


the DMA interface 


SG: 


Option 3A (DMA) pseudo devices 


PX: 




CM: 




DS: 
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DESCRIPTION 

The COPY command transfers data from the specified 
source to the specified destination. 

Data are transferred as a string of 8-bit bytes; no format con- 
version is done, nor are embedded commands executed. 
During the transfer no other processing occurs in the termi- 
nal; everything is queued until the COPY process is com- 
plete. If the destination is HO:, prior data waiting in the 
output queue is transmitted first, and the eighth bit is 
replaced by the appropriate parity bit. 

The copy operation continues until an end-of-file (EOF) is 
reached or the CANCEL key is pressed. If you use the CAN- 
CEL key, the file is closed and any data already written is 
deleted. 

When the destination is a disk file that already exists, the old 
file on the disk is destroyed unless it is write protected. If the 
file or disk is write protected, an error occurs and the copy 
operation is not performed. 

If both the source and destination are disk devices without 
filenames, all files on the disk volume owned by the current 
user are copied. Thus, a COPY with source FO: and destina- 
tion F1 : copies all files with the current user-number from 
the disk volume in Disk Drive onto the disk in Disk Drive 1 . 



User-Number. Only those files belonging to the current user 
(as set by the SET-USER-NUMBER command) are transfer- 
red. If you try to explicitly copy a file that is not of your user- 
number, error JC01 is generated (that is, the file is not 
found). Files not of your user-number ate ignored during a 
copy of an entire disk. 



Devices. For a detailed explanation on the valid devices 
and filenames (including syntax), see the discussion of the 
Dvice parameter type. 



File Transfers. For a complete discussion of the transfers 
performed by this and other file transfer commands, see the 

7iiU OCI *C> A A Wi A I l>£/ Ut 

DEFAULTS 

source 

as shipped — none 
on power-up — none 
if omitted — error JC1 1 

separator 

as shipped — none 
on power-up — none 
if omitted — empty string 



destination 

as shipped — none 
on power-up — none 
if omitted — error JC31 
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ERRORS 



REFERENCES 



Data format error (Options 3A and 9 only). 

Out of memory while attempting DMA 
transfer (Option 3A only.) 

Attempt to copy an entire disk volume 
onto itself (e.g., a copy from FO: to FO:). 

Specified source does not exist, or cannot 
be found. 

Invalid source specifier. 

Out of memory while parsing the parame- 
ter, or while executing the command.) 

Parameter 1 context error (not an input 
device, or device is busy). 

Disk hardware error or drive not ready on 
the source device, or error in DMA block 
transfer. 

Separator parameter missing. 

Invalid separator (must be empty string or 
TO, in Setup mode, must be TO). 

JC22 (Level 3): Out of memory while parsing the 
parameter. 

Specified destination does not exist. 

Invalid destination specifier. 



JC01 


(Level 2) 


JC02 


(Level 3) 


JC03 


(Level 2) 


JC10 


(Level 2) 


JC11 


(Level 2) 


JC12 


(Level 3) 


JC13 


(Level 2) 


-JC19 


(Level 2) 


JC20 


(Level 2) 


JC21 


(Level 2) 



JC30 
JC31 
JC32 



(Level 2) 
(Level 2) 
(Level 3) 



Out of memory while parsing the parame- 
ter, or while executing the command. 

JC33 (Level 2): Parameter 3 context error. (Invalid desti- 

rto+i'-M-i s^AwisNA /4o\i!«a !© Vni icii i~\- ovic*i^'*< 
iiQliuii ucviuc, u&vivo io t_>uoy, \ji w/viom iy 

disk file is protected.) 

JC39 (Level 2): Disk hardware error or drive not ready on 
the destination device, or error in DMA 
block transfer. 



Device parameter type 
EOF-string syntactic construct 
EOL-string syntactic construct 
EOM-indicator syntactic construct 
SET-EOF-STRING command 
SET-EOL-STRING command 
SET-PORT-EOF-STRING command 
SET-USER-NUMBER command 
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c r Character 



DESCRIPTION 

The effect of a c r character depends on whether the dialog 
area is enabled or disabled. 



Dialog Area Disabled. When the terminal receives a c r and 
the dialog area is disabled: 

• The terminal enters Alpha mode (if not already there) 

• 401 0-style GIN is disabled (if it is enabled) 

«Th^ r+f irrcnt linn ^.4-wls-. if* r^.r»^t + ,-. linn r>t.,ln D /nnU ItnstX 
llIU WU> IClll lit it; OkjM^ i£) I C5*3<wL IU lii IC di/l^ W ^OUiiO ill 1C/ 

• On a41 14 and 41 16, line width is reset toO 

A "carriage return" action is then performed. In the 41 14 
and 4116, the alpha cursor moves left to the current margin. 
(If margin 1 is in effect, this is the line x = in terminal space 
coordinates.) In the 41 12, 41 13, and 41 15, the alpha cursor 
moves to the left edge of terminal space (the line x = 0); if 
this point is outside the current window, then the alpha cur- 
sor will not be visible. 

If "CR-implies-LF" mode is in effect (see CRLF command), 
then a "line feed" action is also performed, as if the terminal 
had received a '-f character. 



If the Dialog Area is Enabled. If the terminal is not in alpha 
mode, then the c r character has no effect. 

If the terminal is in alpha mode, then the alpha cursor in the 
dialog scroll is moved to the left end of the current line of 
that scroll. Moreover, if "CR-implies-LF" mode is in effect, 
then a "line feed" action is also performed; this advances 
the alpha cursor to the start of the next line in the dialog 
scroll. 



REFERENCES 

CRLF command 

ENABLE-DIALOG-AREA command 
ENTER-ALPHA-MODE command 
ENABLE-4010-GIN command 
l f character 

SET-LINE-STYLE command 
SET-LINE-WIDTH command 
SET-4014-LINE-STYLE command 
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CRLF Command 

Host Syntax 



E cKR mf.CRLF-mode 



Setup Syntax 



CRLF s p CRLF-mode 



PARAMETERS DEFAULTS 

CRLF-mode (0 or 1 ). CRLF-mode 
Indicates whether a carriage return will imply a line feed as shipped — 

or not. (Setup mode parameters are YES and NO.) on power-up — remembered 



YES; c r implies l f. 
NO; c r does not imply l f. 



if omitted — 



ERRORS 

DESCRIPTION KR11 (Level 2): Invalid CRLF-mode (must be or 1). 

If YES (mode 1) is specified, then when a c r is received by 

the terminal, the terminal displays it as if c r and l f had been REFERENCES 

received; that is, the terminal executes both carriage return 
and line feed . Cr character 

4= character 

If NO (mode 0) is specified, when the terminal receives a c r 
it executes only a c r. 



41 10 SERIES COMMAND REFERENCE 



7-47 



TEK COMMANDS 



DEFINE-MACRO Command 



Host Syntax 



E cKD int: macro-number m\-array:macro-contents 



Setup Syntax 



DEFINE s p macro-number macro-contents 



PARAMETERS 



DESCRIPTION 



macro-number (-32768 through -32742, -32740 through 
-32737, -32608 through -32513, and -1 
through 32767). 
The number of the macro being defined. Macro numbers 
-32768 through -32742, -32740 through -32737, and 
-32608 through -32513 specify "byte-macros", macro 
numbers through 143 specify "key-macros", macro 
numbers 144 through 32767 specify "host-macros", and 
a macro number of -1 means "delete all macros". 

macro-contents (0 to 1 27). 

An int-array with to 65535 elements, with element val- 
ues through 1 27. This parameter defines the charac- 
ters (using their ASCII decimal equivalents) that result 
when the macro is expanded. An array of zero length 
deletes the macro definition for the specified macro 
number. 



The DEFINE-MACRO command defines or deletes a macro 
(or all macros). There are three types of macros: byte- 
macros, key-macros, and host-macros. There is no differ- 
ence in the way that these three macro types are defined or 
stored, only in the ways they are expanded. 

If the macro-number is -1 , all macros are deleted, regard- 
less of the macro-contents parameter. To delete a single 
macro, specify the macro-number and define the macro- 
contents as a zero length array. For macros to 1 43, delet- 
ing the macro definition causes the corresponding key on 
the keyboard to revert to its "unprogrammed" meaning. 

It is possible to save macro definitions specified by this 
command with the save command. See the description of 
the save command for details. 

The macro-contents may include any combination of ASCII 
characters, including any 41 10 command. Nesting of 
macros is permitted, so that one macro may expand 
another. 
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Byte-macros. Byte-macros are expanded when the termi- 
nal's command processor receives a particular character. 
They have macro-numbers in the ranges -32768 through 
-32742, -32740 through -32737, and -32608 through 
-3251 3. These values correspond to the 8-bit ASCII 
character which is reached by adding 32768 to the macro- 
number. The ASCII characters that correspond to these 
macro numbers have the ASCII decimal equivalents 
through 26, 28 through 31 , and 1 60 through 255. For exam- 
ple, macro-number -32768 corresponds to N L, and 
-32737 corresponds to u s. The gaps in the range provided 
for byte-macros are to prevent sensitive characters (such as 
E c and the printable ASCII characters) from being redefined. 

To access the byte-macros corresponding to the 8-bit ASCII 
values 1 60 through 255 (macro-numbers -32608 through 
-32513), you must use either 8-bit packing in block mode, 
or data parity with control over the eighth bit so that you can 
send the corresponding characters to the terminal com- 
mand processor. 



Key-macros. Key-macros have macro-numbers in the 
range through 1 43. Macro-numbers through 1 27 corres- 
pond to the ASCII characters (0 through 1 27) as they are 
typed on the keyboard. Macro-numbers 1 28 through 143 
correspond to the terminal's function keys: 128 through 135 
map onto F1 through F8 (the un-shifted function keys), and 
1 36 through 1 43 map onto S1 through S8 (the shifted func- 
tion keys). 



DEFAULTS 

macro-number 

as shipped — none 
on power-up — none 
if omitted — 

macro-contents 
as shipped — none 
on power-up — none 
if omitted — empty array 

ERRORS 

KD11 (Level 2): Invalid macro number (must range from 
-32768 to -32742, -32740 to -32737, 
-32608 to -3251 3, or -1 to 32767). 

KD21 (Level 2): Invalid int-array (length must be from to 
65535, int values must be in range from 
to 127). 

KD22 (Level 3): Insufficient memory to define macro. 



REFERENCES 

EXPAND-MACRO command 
Key-execute-character 
LOAD command 
SAVE command 



Host-macros. The range of macro-numbers for host- 
macros includes the entire range of macro-numbers. Thus, 
macros to 143 are both hosi-macros and key-macros, and 
macros with numbers less than are both host-macros and 
byte-macros. Host macros are defined as macros that can 
be expanded by the EXPAND-MACRO command only or by 
the EXPAND-MACRO command as well as by other 
methods. 



Expanding Macros. Byte-macros and host-macros are 
expanded with commands from the host, keyboard, or file 
being loaded. Key-macros are expanded with commands 
from these sources and with keystrokes. See the EXPAND- 
MACRO command description for details on expanding 
macros. 
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d t Character 



DESCRIPTION 

If the terminal is in snoopy mode, d t is displayed as a filled 
in character space. If the terminal is in Alpha mode, d t has 
no effect on the terminal. 

If the terminal is in Vector or Marker mode, d t is interpreted 
as a LoY or Extra byte for an xy parameter. If the terminal is 
parsing an int parameter, d t is interpreted as a Hil byte. 

This can present a problem if a host computer also inter- 
sperses d t as a filter character These filler characters coulrt 

be misinterpreted by the terminal as meaningful data. 



Two terminal features are provided to overcome this diffi- 
culty. Firstly, the IGNORE-DEL command lets you specify 
that the terminal is to ignore any d ts which the host may 
send as filler characters. Secondly, the terminal interprets 
the delete-equivalent string, E c?, as if it were the d t 
character. 



REFERENCES 

Delete-equivalent syntactic construct 
IGNORE-DEL command 
Int parameter type 
XY parameter type 
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Delete-Equivalent Syntactic Construct 

SYNTAX 




DESCRIPTION REFERENCES 

The delete-equivalent string, E c?, is interpreted as replacing d t character 

a D x This feature, together with the ignore-DEL command, Int parameter type 

lets you deal with host computers which intersperse d t filler XY parameter type 

characters among the characters they send to the terminal. 

A host can substitute the Delete-equivalent whenever it 

would ordinarily send a D x 
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DELETE-FiLE Command 



OPTIONS 42 , 43, 45 



Host Syntax 



E cJK dev\ce:file-specifier 



Setup Syntax 



DELETE s p file-specifier 



PARAMETERS 

file-specifier 

Specifies the file to be deleted. Valid specifiers are: 



FO:filename 
filename 

F1:filename 

SO:filename - 
Z7:filename 



files on Disk Drive FO: 

files on Disk Drive F1 : 
files on Option 45 devices 



DEFAULTS 

file-specifier 

as shipped — none 
on power-up — none 
if omitted — error JK1 1 



ERRORS 



DESCRIPTION 

This command deletes the specified file from the specified 
disk. 

For example, to delete the file ABCDEF from Disk Drive FO:, 
issue the DELETE-FILE command: 

delete-file : "FO:ABCDEF" 
= E cJK string : "FO:ABCDEF" 
= E cJK9F0:ABCDEF 

You cannot delete a file that has been write-protected with 
the PROTECT command or that is on a write-protected disk. 
If you try to delete such a file, the terminal detects error 
JK13orerrorJK19. 



JKOO (Level 2): Unrecognized command. (Disk drive 

option is not installed.) 
JK10 (Level 2): The specified file or disk drive does not 

exist. 
JK11 (Level 2): \maWd file-specifier. 
JK12 (Level 3): Out of memory while parsing parameter. 
JK13 (Level2): The specified device is not a disk drive, is 

write-protected, is busy, or detects a bit 

map error. 
JK19 (Level 2): Disk hardware error. (I/O error, drive not 

ready, or hardware write-protect error.) 

REFERENCES 

PROTECT command 
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DELETE-GRAPHTEXT-CHARACTER Command 



Host Syntax 




Setup Syntax 



E cSZ s p font-number char-number 



PARAMETERS 

font-number (-1 to 32767). 

Specifies the font from which the character is deleted. 

-1 ai! fonts 

to 32767 specifies a font 

char-number (-1 , or 32 to 1 26). 

The numeric equivalent of a character within the 
specified font. 

-1 all characters 

32 to 1 26 specifies a character 

DESCRIPTION 

The named character of the specified user-defined 
graphtext font is deleted. Using a number of "-1 " deletes all 
items of that nature, as follows: 

font-number = -1 : deletes all user-defined characters 
in all fonts. 

char-number = -1 : deletes all user-defined characters 
in the specified font. 

If you specify a font-number of -1 , the char-number param- 
eter is ignored. 

If the specified character number does not exist in the spec- 
ified font, a type SZ20 error is detected. 



» « l lOl 1 C4 UOCl "XlClll ICU ^jl dpi 1LG/VL Ol IQI CUsLCl IO UdGtdi, 1 1 IO 

superceded by the corresponding predefined character for 
that font. For most fonts, that is the same as the correspond- 
ing character in the standard ASCII font (font 0). However, if 
a keyboard option is installed, and the font is font 1 , 3, 7, 9, 
1 0, or 1 1 , then this is the corresponding character of the 
U.K., Swedish, APL, Danish/Norwegian, or Katakana font. 
See the SET-GRAPHTEXT-FONT command. 

Specifying a font-number of -1 not only deletes all charac- 
ters in all user-defined fonts, but also deletes all user- 
defined graphtext font grid definitions and resets the current 
graphtext font (as set by the SET-GRAPHTEXT-FONT com- 
mand) to 0. Fonts numbered 0, 1,3,7,9, 10, and 11 —the 
predefined fonts — cannot be deleted. If you ry to delete 
these fonts, error SZ1 1 is generated. 

Specifying a char-number of -1 not only deletes all the char- 
acters in the specified font, but also deletes the graphtext 
font grid for that font. 

If the font-number specified is the current graphtext font, 
and the char-number is -1 , then the current graphtext font is 
reset to 0. 
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DEFAULTS REFERENCES 

font-number SET-GRAPHTEXT-FONT command 

as shipped — none SET-GRAPHTEXT-FONT-GRID command 

on power-up — none 
if omitted — 

char-number 

as shipped — none 
on power-up — none 
if omitted — 

ERRORS 

SZ03 (Level 2): Command is invalid at this time. (A 

graphtext character is currently being 
defined.) 

SZ1 (Level 1 ): The specified font does not exist (no char- 
acters have been defined for that font). 

SZ1 1 (Level 2): Invalid font-number (must range from -1 
to 32767, excluding 0, 1 , 3, 7, 9, 10, and 
1 1 — the predefined fonts). 

SZ20 (Level 1): The character specified does not exist in 
this font. 

SZ21 (Level 2): Invalid character-number. (Must be -1 , or 
range from 32 to 126.) 
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Host Syntax 



E cSK mtsegment-number 



Setup Syntax 



E cSK s p segment-number 



PARAMETERS 

segment-number (-3, -1 , or 1 to 32767) 
The number of the segment to be deleted. 

-3 all segments that match the current 

matching class 

-1 all segments 

1 to 32767 a specific segment 

DESCRIPTION 

This command removes the specified segment from mem- 
ory. If the segment is currently being defined, the segment 
definition is terminated, and then the segment is deleted. 

On a 41 1 4 and 41 1 6, if the segment is currently visible on 
the screen and displayed in refresh mode, it is removed 
from the display. If the segment is in storage it is not 
removed until the next time the page is erased. 

On a 41 1 2, 41 1 3, or 41 1 5, the display is updated to the 
extent specified by the most recent SET-FIXUP-LEVEL 
command. 



If tho narnmotor is -1 all wnments are deleter) fThis does 

not include segment 0, the cross-hair cursor, which cannot 
be deleted.) 

If the parameter is -3, then all segments that match the cur- 
rent matching class are deleted. 

Segments cannot be protected against deletion. Before 
issuing the DELETE-SEGMENT command, take care that 
the command is really needed and that the segment- 
number being deleted is correct. 

If the segment you want to delete is assigned as the GIN- 
cursor, and GIN is enabled, the terminal reports error SK13 
and the segment is not deleted. If you specified -1 or -3 as 
the segment-number parameter, all segments except the 
G!N-cursor are deleted, and error SKI 3 is reported. 

In the 41 1 2, 41 1 3, and 41 1 5, if all segments and all views 
are to be deleted, it is faster to delete views first, and then 
delete segments. It is also faster to set the./ua<p-feve/to 0, 
delete the segments, renew the view, and then restore the 
or\q\n3\ fixup-level. 
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DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — error SK1 1 



ERRORS 

SK02 (Level 3): Out of memory while attempting to delete 
a segment (41 12, 41 13, 41 1 5 only). 

SK1 (Level 1 ): Segment does not exist. 

SK11 (Level 2): Invalid segment number (must be -3,-1, 
or range from 1 to 32767). 

SK13 (Level 2): Segment specified is an active 
GIN-cursor. 



REFERENCES 

BEGIN-HIGHER-SEGMENT command 
BEGIN-LOWER-SEGMENT command 
BEGIN-NEW-SEGMENT command 
BEGIN-SEGMENT command 
END-SEGMENT command 
SET-FIXUP-LEVEL command 
SET-GIN-CURSOR command 
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DELETE-VIEW Command 



4112,4113,4115 



Host Syntax 



E cRK inl.view-number 



Setup Syntax 




PARAMETERS 

view-number (-1 to 64). 

Names the view to be deleted. 

-1 all views 

the current view 

1 to 64 specifies a view 

DESCRIPTION 

This command deletes the designated view. If the view- 
number is 0, the current view is deleted. If the view-number 
is -1 , all views are deleted. 

If the current view is deleted, the next view higher (or the 
lowest remaining view if none higher exist) becomes the 
current view, if there are no other views (e.g., after view- 
number = -1), then view 1 (the default view) is selected and 
initialized. The default view has a full viewport and, on a 
41 1 2 and 41 13, a window from X = OtoX = 4095 and from 
Y = OtoY = 3127. On a 41 15, the window for the default 
view is the current partial overview window (see SET-OVER- 
VIEW-WINDOW for details). 

When all views are deleted, the visibility of all existing seg- 
ments is turned off. 



If you want to delete all segments anu an views are iO uQ 
deleted, it is faster to delete views first, and then delete 
segments. 

The "default view," created on power-up (or on a DELETE- 
VIEW: -1 command) has the following attributes: 

View number: 1 

Window: 41 1 2, 41 1 3: X = to 4095, Y = to 31 27; 

4115:X = 0to4095,Y = 0to3276 
Full overview window: 41 15: X = to X = 4095, 

Y = OtoY = 4095 
Partial overview window: 41 1 5: X = to X = 4095, 

Y = OtoY = 3276 
Viewport: 4112,4113: X = 4095, Y = 3071; 

4115:X = 4095, Y = 3276 
Surface number: 1 
Border: invisible 
Wipe Index: 
Border index: 41 1 2: 6; 41 1 3, 41 1 5: 1 



DEFAULTS 

view-number 

as shipped — none 
on power-up — none 
if omitted — 
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ERRORS REFERENCES 

RKOO (Level 0): Unrecognized command. (The terminal is DELETE-SEGMENT command 

not a 41 12, 41 13, or 41 15.) SELECT-VIEW command 

RK10 (Level 2): The designated view does not exist (has SET-OVERVIEW-WINDOW command 

not been defined with a select-view 
command). 

RK11 (Level 2): Invalid view number (must range from 
-1 to 64). 
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Host Syntax 



device = mtlength 



' device-name 
device-name filename 
device-name parameter 

, filename 



Setup Syntax 



device = 



device-name 
device-name filename 
device-name parameter 
filename 




DESCRIPTION 

Device parameters are used in file transfer commands and 
in the REPORT-DEVICE-STATUS command. File transfer 
commands are COPY, DIRECTORY, LOAD, PLOT, PORT- 
COPY, SAVE, and SPOOL. This parameter type is also used 
in commands that set attributes for the ports on Option 10, 
the Three Port Peripheral Interface (3PPI). 

Device parameters are string parameters when they are 
sent from the host, but have a Setup mode syntax slightly 
different from that of strings. In Setup mode, no leading or 
trailing delimiters are needed (as are needed for normal 
string parameters). The length int is required when the com- 
mand comes from the host. 

A valid device parameter is a device-name, a device-name 
with a filename, a device-name with parameter characters, 
and a filename by itself. The devices that are recognized as 
being present depend on the options that are installed in the 
terminal. 

A device-name consists of three characters. The first two 
characters must be any ASCII characters except s p, *,.,:, ;, 
<, = , >, ?, „ [, ], and . The last character must be a colon (:). 



A filename consists of two parts, the name and the exten- 
sion. The name can be from one to eight characters long, 
and the extension can be from one to three characters long. 
If you include the extension, separate it from the name with 
a period (.). All ASCII characters except s p, * , ., :, ;, <,=,>, 
?, „ [> ]. and .Control characters are ignored when they are 
received from the host, but are not valid when entered in 
Setup mode. If extra valid characters are added to the name 
or the extension, they are ignored. 

Some devices have parameters. These parameters specify 
special action for the device. They can be any string of char- 
acters that are valid for filename. See the explanations of 
the different devices later in this description for the parame- 
ters and their meanings. 

During all file transfer operations (except a spooling opera- 
tion not involving the host port), the keyboard is discon- 
nected, so that if a key is pressed during the transfer 
operation, its data goes into a 1 70-byte queue until the 
transfer is complete. When the queue becomes full, the ter- 
minal bell rings each time a key is pressed, and the terminal 
discards the character generated by that key. 

Devices can be divided between physical devices and 
pseudo devices. Physical devices have associated hard- 
ware, such as the host communication port, a disk drive 
(Options 42 and 43), or the 3PPI (Option 1 0). Pseudo 
devices exist only in terminal memory as a pattern of data 
stored in a special location. Examples of pseudo devices 
are the color map (Option 3A) and the terminal display 
(Option 9). 
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The Host Port Device 

HO:, the host communication port, is the only standard 
device, available on all terminals. This port is controlled by 
parameters that can be set by various commands. If you 
want to see what these parameters are and how they are 
set, enter a STATUS COMMUNICATIONS command from 
Setup mode. 

A parameter that is particularly important is the parity set- 
ting, which controls whether seven-bit or eight-bit charac- 
ters are transmitted. If parity is DATA, the eighth bit is 
treated as part of the character being sent. If not, the eighth 
bit is controlled by an algorithm that depends on the other 
bits in the character. Since all pseudo devices transmit 
eight-bit data, if the host port parity is not set at DATA, data 
sent to or from a device requiring eight-bit data is useless. If 
Option 1 is present, Block mode can used to transmit eight- 
bit characters even if DATA parity is not used. 

When HO: is used as a source device in a file transfer oper- 
ation, the terminal sends all characters that it receives at the 
host port after the operation is started to the destination 
device. The terminal continues to send until it detects an 
End-Of-File (EOF). The EOF is either an EOF-string as set 
by a SET-EOF-STRING command if the terminal is not in 
Block mode, or an end-of-file-control-bit if the terminal is in 
Block mode. After the EOF, all further characters are routed 
to the terminal's command processor as usual. 

When HO: is the destination device in a data transfer, the 
contents of the file are routed through the terminal's report 
sending system. When the terminal detects an EOF from 
the source device during the transfer, it sends an EOL- 
string, EOF-string, EOL-string sequence to the HO: port to 
terminate the transfer. 



The Disk Drive Devices. 

If Option 42 is installed in your terminal, device FO: 
addresses it. If Option 43 is installed, FO: addresses the 
right disk unit and F1 : addresses the left one. If Option 45 is 
installed, devices with the first character of S, T, U, V, W, X, 
Y, or Z and the second character 0,1,2, 3, 4, 5, 6 or 7 
address the devices which may be connected to the hard- 
ware associated with the option. The specific device name 
used depends on how the option hardware was set at instal- 
lation. You can find out whether an Option 45 device is avail- 
able with the REPORT-DEVICE-STATUS command. 



These devices can include a filename after the three char- 
acter device specifier. Do not include a space between the 
last character of the device-name (:) and the first character 
of the filename. 

If only a filename is used without the three character device 
specifier, the device FO: is assumed, when Option 41 or 43 
is installed. If neither Option 42 or 43 is installed, but Option 
45 is installed, the assumed drive is the first device attached 
to the Option 45 interface. 

All data is stored on disk files as eight-bit bytes. If the file 
came from the host port, the high bit in each byte is the par- 
ity bit as received from the host. 

The Peripheral Port Devices 

If option 10 is installed in your terminal, three ports, P0:, P1 : 
and P2:, are available for connecting RS-232C compatible 
peripherals. Several device drivers are provided for differ- 
ent peripherals which may be connected The peripherals 
for which the terminal has device drivers are: 

• TEKTRONIX 4662 Interactive Digital Plotter 

• TEKTRONIX 4663 Interactive Digital Plotter 

• TEKTRONIX 4643 Line Printer 

The ports may also be used for any compatible device, such 
as the TEKTRONIX 4923 Cartridge Tape Unit. 

The data transferred to and from a peripheral port is format- 
ted according to the current settings for that port; enter a 
STATUS 3PPI command from Setup mode to see a list of 
these parameters. If a plotter or printer device driver is 
assigned to a port, that port cannot be used as a source for 
any file transfer. If you specify the port as a source, an error 
will occur. 

When an EOF is detected in a transfer to a peripheral port, 
the port-EOF-string is sent to the attached peripheral and 
the transfer is terminated. The port-EOF-string is also used 
to mark the end-of-file for a transfer from a peripheral port. 
Any characters received at the port after the port-EOF- 
string are lost. 
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The Color Hardcopy Devices 

If Option 9 is installed in a 41 1 3 or 41 1 5 terminal, two addi- 
tional devices, SC: and HC:, are available. 

SC:, a pseudo device, is valid as a source device for the 
COPY, SPOOL, and REPORT-DVICE-STATUS commands 
only. It specifies the terminal's raster memory. The data 
specified by SC: is in the special format required by the HC: 
device to copy onto a color hardcopy device. 

HC: is valid only as a destination device for the COPY and 
SPOOL commands. It specifies the color hardcopy interface 
that is installed as part of Option 9. There are two valid 
parameter characters for this device. HC:0 specifies that 
black is copied as white on the color hardcopy device. HC:1 
specifies that black copies as black on the color hardcopy 
device. If you specify HC: without a parameter, black copies 
as white. 

Data from SC: is in a very strict format, and HC: accepts 
data only in the format generated by SC:. 



The DMA Devices 

If Option 3A is installed on a 41 15 terminal, five devices are 
added to the list of valid devices. One of these, DM:, is a 
physical device, the other four, DS:, SG:, PX:, and CM:, are 
pseudo devices. The pseudo devices are valid for the 
COPY, SPOOL, and REPORT-DEVICE-STATUS commands 
only; DM: is valid for all file transfer commands. 

DM: specifies the DMA interface port. There are two valid 
parameter characters for this device. DM:0 specifies that 
data is sent through the DMA interface (either input or out- 
put) in Burst mode. DM1 : specifies that data is sent through 
the interface in Single-cycle mode. 

Burst mode means that the DMA transfer process is the only 
process operating in the host computer environment for 
each block of data that is to be transferred. Single-cycle 
mode means that the DMA transfer process and the host's 
Central Processing Unit operate at alternate cycles of the 
host's clock. While DMA transfers take longer in Single- 
cycle mode, they do not monopolize the host computer's 
processor. 

The power-up default for the parameter is 1 , or Single-cycle 
mode. If you specify only DM: without a parmeter, the 
parameter defaults to the last parameter specified, or, if 
none was previously specified, to the power-up default 
value. 



DMA Pseudo Devices. The pseudo devices available with 
Option 3A are DS:, SG:, PX:, and CM:. 

DS: specifies the vector display list. It is valid as a destina- 
tion device only. DS: stores the current viewport attributes, 
displays the data that it receives, and restores the previ- 
ously stored attributes. There are no parameters for the DS: 
device. 

DS: requires a special data format. For details on this data 
format and for more information on the use of this pseudo 
device, see the 4115 Option 3 A Instruction Manual. 

SG: specifies the retained segment list. It is valid as both 
source and destination. You can transfer individual seg- 
ments, all segments, or all segments that match the current 
matching class. You can specify which segment(s) you want 
transferred when SG: is the source device by adding a 
parameter to the device-name. Vaiid parameters are: 

-1 Specifies all segments (equivalent to seg- 

ment-number -1 in segment commands). 

-3 Specifies all segments that match the cur- 

rent matching class (equivalent to segment- 
number -3 in segment commands). 

1 to 32767 Specifies the individual segments of the 
given number. 

If you specify -1 or -3 as the parameter, segment visibility, 
priority, and class are set the same as those of the default 
segment (segment number = -2). This is because it is not 
possible to set these attributes for each of multiple seg- 
ments sent in one transfer. 

When SG: is the destination device, it expects the source 
device to specify segment numbers for the segments being 
written within the data stream. Before you specify SG: as 
destination, close any segments, panels, and graphtext 
characters that might be open. If you leave any of these 
open, SG: closes them for you and issues a warning mes- 
sage. If a segment received by SG: already exists, the old 
definition is replaced by the newly received definition. 

The power-up default parameter specifies all segments (A). 
If you do not include a parameter, the last parameter speci- 
fied is used; or, if none has been previously specified, the 
power-up default is used. 
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SG: requires a special data format. For details on this data 
format and for more information on the use of this pseudo 
device, see the 4115 Option 3A Instruction Manual. 

PX: specifies the current pixel viewport. It is valid as both 
source and destination. PX: allows information on the 
screen to be directly transferred to the host (via the DM: 
device), or information from the host to be directly displayed 
on the terminal screen. 

Before you specify PX: as a device, you must first set up a 
pixel viewport. You can specify whether you want the pixel 
data (either source or destination) to be raw or normalized, 
and whether you want it runlength encoded or non-runlength 
encoded by adding a parameter after the device-name. 

Raw data is data that does not need to be changed before it 
is written onto the terminal display. Normalized data must 
be manipulated before it can be written onto the terminal 
display. Runlength encoded data allows you to specify a 
number of pixels of the same color index (much like the 
RUNLENGTH-WRITE command), and non-runlength 
encoded data one pixel at a time (much like the RASTER- 
WRITE command). The parameters that specify the differ- 
ent forms of data are: 

raw, non-runlength encoded data 

1 normalized, non-runlength encoded data 

2 raw, runlength encoded data 

3 normalized, runlength encoded data 

The power-up default parameter specifies raw, non- 
runlength encoded data (0). If you do not include a parame- 
ter, the last parameter specified is used; or, if none has been 
previously specified, the power-up default is used. 



PX: requires a special data format. For details on this data 
format and for more information on the use of this pseudo 
device, see the 4115 Option 3 A Instruction Manual. 

CM: specifies the color map. It is valid as both source and 
destination. If CM: is the source device, the terminal sends 
the entire color map. If CM: is the destination device, the 
terminal accepts either the whole color map or part of the 
color map. 

When CM: is the destination, the color map is loaded from 
the high index (255) down. The terminal loads the indices as 
they are received, so if fewer than 256 indices are sent, the 
lower indices of the color map are not loaded with new data. 

There are no parameters for CM:. 

CM: requires a special data format. For details on this data 
format and for more information on the use of this pseudo 
device, see the 4115 Option 3 A Instruction Manual. 

REFERENCES 

4115 Option 3 A Instruction Manual 
COPY command 
DIRECTORY command 
LOAD command 
PORT-ASSIGN command 
RASTER-WRITE command 
REPORT-DEVICE-STATUS command 
RUNLENGTH-WRITE command 
SAVE command 
SET-PARITY command 
SET-EOF-STRING command 
SPOOL command 
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Device-Status-Report Message Type 



SYNTAX 



device-status-report 
device-specifier 


= [sig-char] 

device-specifier 

}n\-repor\:staius-word 

EOM-indicator 

char-report char-report 



PARTS OF THE REPORT MESSAGE 



DESCRIPTION 



The signature character for non-GIN reports, as set by 
the most recent SET-REPORT-SiG-CHARS command, if 
this character is N u, it is omitted. 

device-specifier. 

Two char-reports specifying the device whose status is 
being reported: 

s p s p Invalid device. 

HO Host communication port 

FO Disk Drive FO:. 

F1 Disk Drive F1:. 

SO — Option 45 devices. 

Z7 

PO RS-232 peripheral port PO:. 

P1 RS-232 peripheral port P1 :. 

P2 RS-232 peripheral port P2:. 

SC Option 9 SC: pseudo device. 

HC Color hardcopy interface. 

DM DMA interface. 

DS DMA DS: (non-retained segment) pseudo 

device. 
SG DMA SG: (retained segment list) pseudo 

device. 
PX DMA PX: (current pixel viewport) pseudo 

device. 
CM DMA CM: (color map) pseudo device. 

status-word. 

A number whose binary bits hold status information, see 
Tables 7-3, 7-4, 7-5, 7-6, 7-7, and 7-8. 



The Device-Statiis-Re n ort is sent b v the terminal to the host 
computer in response to a REPORT-DEVICE-STATUS 
command. 

When the terminal sends a report to the host bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 

Sig-char. The first item in the report is the signature charac- 
ter, as set by the most recent SET-REPORT-SIG-CHARS 
command. If this character is N u, then it is omitted from the 
report. 



Device Mnemonic. The second item is a two-character 
device mnemonic, sent as two char-reports. The codes 
which may occur here are the first two characters from the 
REPORT-DEVICE-STATUS command's device-specifier 
parameter, if the parameter was valid, or two s p characters. 

Status-Word. The status-word parameter contains an inte- 
ger in the range from to 32767. When the integer is repre- 
sented as a 1 5-bit binary numeral, some of its bits hold 
status information about the device named in the device 
mnemonic. 

If the REPORT-DEVICE-STATUS command had an invalid 
device-specifier string, or if the device is not present, then 
the status-word parameter is 0. 

The status-word for the host communication port (HO) is 
always 1 . 



EOM-indicator. 

See the description of the EOM-indicator. 
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Table 7-3 lists the meanings of the bits in the status integer 
for all disk drives. 

Table 7-4 lists the meanings of the bits in the status integer 
for an RS-232 peripheral port. 

Table 7-5 lists the meaning of bits in the status integer for 
the Option 9 screen pseudo device. 

Table 7-6 lists the meaning of bits in the status integer for 
the color hardcopy interface. 

Table 7-7 lists the meaning of bits in the status integer for 
the DMA interface. 

Table 7-8 lists the meaning of bits in the status integer for 
the Option 3A (DMA interface) pseudo devices. 



Table 7-3 
STATUS INTEGER FOR DISK DRIVE 

B15 B14 B13 B12 B11 B10 BS B8 B7 B6 B5 B4 B3 B2 B1 BO 

X X X X X X XXXWRXDXBP 

The meanings of the bits (when set to 1 rather than 0) are as 
follows: 

X Reserved for future use. 

W The disk drive write protect switch was on when the 
disk drive door was last closed. 

R The disk drive is ready. That is, a disk volume is 
installed and the door is closed. 

D A double-sided diskette is installed. 

B The disk drive is busy (performing a read or write 
operation). 

P This disk drive is installed in the terminal. 



Table 7-4 
STATUS INTEGER FOR RS-232 PERIPHERAL PORT 



B15 B14 B13 B12 B11 


B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 


BO 


X 


X 


X 


X 


X 


X X 


X 


X 


X 


X 


X 


X 


X 


B 


P 



The meanings of these bits (when set to 1 rather than 0) are 
as follows: 

X Reserved for future use. 

B Peripheral port is busy. 

P This peripheral port is installed in the terminal. (This 
does not necessarily mean that there is a peripheral 
device attached to the the peripheral pui l.) 



Table 7-5 

STATUS INTEGER FOR COLOR HARDCOPY INTERFACE 

(SC) 

B15 B14 B13 B12 B11 B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 BO 



X X X X 



X XXXXXXXXBP 



The meanings of these bits (when set to 1 rather than 0) are 
as follows: 

X Reserved for future use. 

B The screen pseudo device is busy. 

P The screen pseudo device is present. 
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Table 7-6 

STATUS INTEGER FOR COLOR HARDCOPY INTERFACE 

(HC) 



B1 


5 B14 B13 


B12 B11 


B10 BS B8 B7 B6 B5 B4 B3 B2 B1 


BO 


X 


X 


X 


X 


X 


X X 


X I 


A 


X 


X 


C 


F 


B 


P 



The meanings of these bits (when set to 1 rather than 0) are 
as follows: 

X Reserved for future use. 

I The image is produced parallel with the long axis of 
the media (as opposed to with the short axis). 

A The copier has acknowledged a data transfer. 

C The copier is connected and powered-up. 

P A r»nni^r fai lit nnnHitlrun avictc 

B The copier is busy. 

P The color copier interface is present. 

Table 7-7 
STATUS INTEGER FOR DMA INTERFACE (DM) 



B15 B14 B13 B12 B11 


B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 


BO 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


M 


B 


P 



The meanings of these bits (when set to 1 rather than 0) are 
as follows: 

X Reserved for future use. 

M DMA/host interaction is in Single-cycle mode (as 
opposed to Burst mode.) 

B The device is busy. 

P The DMA interface is present. 



Table 7-8 
STATUS INTEGER FOR OPTION 3A PSEUDO DEVICES 



B15 B14 B13 B12 B11 


B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 BO 


X 


X 


X 


X 


X 


X X 


X 


X 


X 


X 


X 


X 


X 


B 


P 



The meanings of these bits (when set to 1 rather than 0) are 
as follows: 

X Reserved for future use. 

B The pseudo device is busy. 

P The pseudo device is present. 

EOM-lndicator. The EOM-indicator serves to terminate the 
report. If the terminal is not in block mode, this is just the 
current EOL-string, as set by the most recent SET-EOL- 

\j i i iiiiv> ^wiiiuicii iu. i ypiwdiiy, u 10 cl nondiauici. n mc ici* 

minal is in block mode, the EOM-indicator is sent by ending 
the block and setting the block's end-of-message bit. See 
the EOM-indicator and block-control-bytes descriptions for 
details. 



REFERENCES 

Char-report syntactic construct 
Eom-indicator syntactic construct 
Int-report syntactic construct 
REPORT-DEVICE-STATUS command 
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DIALOG Key 



DESCRIPTION 



REFERENCES 



The DIALOG key has an effect similar to the SET-DIALOG- 
AREA-VISIBILITY command. Pressing the key when the 
light is off turns on the light in the key and causes the termi- 
nal to execute a SET-DIALOG-AREA-VISIBILITY : 1 com- 
mand, making the dialog area visible. Pressing the key 
again turns off the light in the key and causes the terminal to 
execute a SET-DIALOG-AREA-VISIBILITY : command, 
making the dialog area invisible. 



ENABLE-DIALOG-AREA command. 
SET-DIALOG-AREA-VISIBILITY command. 
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DIRECTORY Command 



OPTIONS 42, 43, 45 



Host Syntax 



E cJD dev\ce:source [str'mg:separator [dev\ce:destination]] 



Setup Syntax 



DIRECTORY s p source TO [destination]] 



kAkaMETERS 

source 

The device or filename for which a directory is desired. 
Valid specifiers are all disk option devices and files and 
the empty string. 

separator 

Empty string or TO. 

destination. 

Specifies the device to which the directory information is 
to be sent. Valid destinations are the host computer, all 
disk option files, all peripheral port devices, the DMA 
interface port.and the empty string. 



riAAlinAfiMi ThA hAet /Uin-\ A nw Hicls f ila thanUA iniar. 

face port, and any peripheral port are valid destinations. An 
empty string in this field sends the directory report to the ter- 
minal screen. 

The directory report includes only the files that are "owned" 
by the current user. That is, only those files marked with the 
current user-number axe reported. Seethe SET-USER- 
NUMBER comand for information about user-numbers. 

Figure 7-4 shows a typical directory report, both for a disk 
(Figure 7-4A) and for a single file (Figure 7-4B). Note that file 
size is reported only for a single file directory report. 



DEFAULTS 



DESCRIPTION 

The DIRECTORY command sends the directory of the 
specified device or file, to the specified destination device 
or file. The directory is sent as if it were a file being sent by 
the COPY command, or if the destination is the terminal 
screen (null parameter), by the LOAD command. 



Source. If a disk device is specified without a filename, the 
entire directory of the current user number is sent to the 
destination device. An empty string in this field is equivalent 
to the default device. If a filename is specified, only the 
directory entry for that file is sent. 



source 

as shipped — none 
on power-up — none 
if omitted — empty string 

separator 

as shipped — none 
on power-up — none 
if omitted — empty string 

destination 

as shipped — none 
on power-up — none 
if omitted — empty string 
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JDOO 


(Level 2) 


JD10 


(Level 2) 


JD11 


(Level 2) 


JD12 


(Level 3) 



ERRORS 

Unrecognized command. (Disk drive 
option is not installed.) 

The specified source device does not exist 
or cannot be found. 

Invalid source specifier. 

Out of memory while parsing the parame- 
ter, or while executing the command. 

JD1 3 (Level 2): Context error in parameter 1 . (The speci- 
fied device is not a disk drive, or failed 
reading bit map.) 

JDia (Level 2): Disk hardware error (or drive not ready) 
for the disk drive whose directory is being 
requested. 

JD20 (Level 2): Separator parameter missing. 

JD21 (Level 2): 



JD22 (Level 3): 



Invalid separator (must be empty string or 
TO). 

Out of memory while parsing the 
parameter. 



JD30 (Level 2): The specified destination does not exist. 

JD31 (Level 2): Invalid destination specifier, 

JD32 (Level 3): Out of memory while parsing the parame- 
ter, or while executing the command. 

JD33 (Level 2): Parameter 3 context error. (The device 

specified is not a valid destination device, 
or is write-protected.) 

JD39 (Level 2): Hardware error for the destination device. 
(I/O error, write-protect error, disk drive 
not ready, or DMA block transfer error.) 



REFERENCES 

COPY command 
Device parameter type 
SET-USER-NUMBER command 



DRIVE FO: 


USER NUMBER 


12 


DRIVE FO: 


USER NUMBER 


12 


-NAME 




PROTECT 


-NAME 


BLOCKS 


PROTECT 


PRACTICE.EXE 




YES 


PRACTICE. EXE 


32 


NO 


HAVE. A 




NO 


_ 






GOOD. DAY 




NO 


-ENTRIES USED: 


6 




- 






-ENTRIES FREE: 


314 




-ENTRIES USED: 


6 




-BLOCKS USED: 


32 




-ENTRIES FREE: 


311 




-BLOCKS FREE: 


276 




-BLOCKS USED: 


40 




-BLOCK SIZE: 


2048 




-BLOCKS FREE: 


268 










-BLOCK SIZE: 


2048 




B 






A 
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Figure 7-4. Directory Command Report Format. 
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DISABLE-GIN Command 
Host Syntax 



E clD m\:device-function-code 



Host Syntax 



GINDiSABLE s p device-function-code 



DADAUCTCDC CDDrtDC 

i nt lMiiiL. i ^i iw h-i irix^i »** 

device-function-code. 1011 (Level 2): Invalid device-function. (Seethe 
Specifies the GIN device-function combination which is ENABLE-GIN command for a table of 

being disabled. For valid values, see ENABLE-GIN device-function codes.) 

command, 

REFERENCES 
DESCRIPTION 

ENABLE-GIN command. 
Disables the specified GIN device-function combination. GIN-report-sequence message type. 

The device-function codes are the same as for the ENABLE- 
GIN command; see the description of that command for 
details. However, a device-function code : -1 disables all 
devices for which graphic input is enabled. 

If the specified function is already disabled, the command is 
ignored. Likewise, if the specified device is for an option 
which is not present, the command is ignored; an error is 
not generated. 

When a device-function combination is disabled, the termi- 
nal sends the rest of the GIN-report-sequence, that is, the 
appropriate term-sig-char and EOM-indicator. See the 
GIN-report-sequence description for details. 

This command disables the GIN function on the named 
device. It leaves the device and its port (if any) active and 
addressable for further action. 
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DISABLE-4953-TABLET-GIN Command 



Host Syntax 



E c! char.disable-code 



PARAMETERS 

disable-code 

Any other ASCII character whose second-least-signifi- 
canl bit is zero, and whose fourth-least-signiiicant 
bit is one. 



DESCRIPTION 

This disables the terminal's emulation of a TEKTRONIX 
4010 Series terminal equipped with a 4953 or 4954 Graph- 
ics Tablet. 



ERRORS 

101 1 (Level 2): Invalid device-function. (See the 

ENABLE-GIN command for a table of 

UC fiCC-J tAUK.Ll\Jtl WUUCO.y 



REFERENCES 

ENABLE-4953-TABLET-GIN command. 
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DISMOUNT Command 



OPTIONS 42, 43, 45 



Host Syntax 



E cJJ dev\ce:device 



Setup Syntax 



DISMOUNT s p device 



PARAMETERS 

device 

the name of the device to dismount. Valid devices are: 



Option 42 and 43 disk drives 
Option 45 devices 



FO: 
F1: 

SO: - S7: 
T0:-T7: 
UO: - U7: 
V0:-V7: 
WO: - W7: 
X0:-X7: 
YO: - Y7: 
Z0:-Z7: 



DESCRIPTION 

This command tells the terminal that the disk in the speci- 
fied device has been replaced, and that the terminal should 
scan the new disk to determine data allocation and blocking 
before it performs any further operations on this drive. This 
command is necessary because the not all disk devices 
report a door-open condition to the terminal. 



IUU UU 1IUI 1ICCU LU UdC Hit? L^IOIVIWUI^ I UUII II HCtl IU II. 

• An input/output attempt fails because the device is not 
ready. 

• The device reports "door open". 

• The terminal as just been turned on (i.e., an operation is 
the first to take place on the device since the terminal 
has been turned on). 

• Non-removable media (e.g. Winchesters) never need to 
be dismounted. 



DEFAULTS 

device 

as shipped — none 

on power-up — none 

if omitted — Options 42, 43: FO: 

Option 45 only: the first device connected 

no disk options: error JJOO 



ERRORS 



JJOO (Level 0): Unrecognized command; firmware is Ver- 
sion 3 or earlier, or there are no disk 
options installed. 

JJ 1 (Level 2): The device parameter does not exist, 

JJ11 (Level 2): Invalid device parameter. 

JJ13 (Level 2): Parameter 1 context error (not a valid 
device, or device is busy). 
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DRAW Command 



Host Syntax 



E cLG xy.position 



Setup Syntax 



E cLG s p position 



PARAMETERS 



DEFAULTS 



position (41 1 2, 41 1 3: X = to 4095, Y = to 4095; 

4115:X = -2 31 to(2 31 H.Y = -2 31 to(2 31 )-1) 
Specifies the end point of the vector to be drawn. 



DESCRIPTION 

The DRAW command causes the terminal to draw a vector 
(a line) from the current graphic beam position to the point 
specified in the command's parameter. The vector is drawn 
in the current line style and line index. The graphic beam 
position is updated to the end point of the vector. 

The DRAW command has two formats: explicit and implicit. 
The explicit DRAW command is E cLG xy. It does not depend 
upon or change the terminal's mode; it is executed as any 
other escape-sequence command. 

The implicit DRAW command syntax is an xy when the ter- 
minal is in Vector mode and the move/draw flag is set to 
draw. The ENTER-VECTOR-MODE command (the G s char- 
acter) puts the terminal into Vector mode and sets the move/ 
draw flag to move. The first xy that is not part of an 
escape-sequence command after the G s causes a move, 
and sets the move/draw flag to draw. A b l character also 
sets the move/draw flag to draw. 



position 

as shipped — none 
on power-up — none 
if omitted — 0,0 



ERRORS 

LG11 (Level2): Invalid position (41 12, 411 3: X and Y both 
range from to 4095; 41 15: X and Y both 
range from -2 31 to 2 31 -1). 

REFERENCES 

ENTER-VECTOR-MODE command 
MOVE command 
SET-LINE-INDEX command 
SET-LINE-STYLE command 
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Host Syntax 



E cLH xy -.marker-position 



Setup Syntax 



E cLH s p marker-position 



PARAMETERS 

marker-position (41 1 2, 41 1 3: X = to 4095, Y = to 4095; 
4115: X = -2 31 to 2 31 -1 , Y = -2 31 to 2 31 -1) 
The position in terminal space at which a marker is 



drawn. 



marker-position 
as shipped — none 
on power-up — none 
if omitted — 0,0 



DESCRIPTION 

The DRAW-MARKER command draws a marker of the cur- 
rent marker type at the specified point. The marker is drawn 
in the current line index, as set by the most recent SET- 
LINE-INDEX command. The graphic beam position is 
updated to the specified point. 

The DRAW-MARKER command received during a panel 
definition does not draw a marker. Instead, it defines a ver- 
tex of the panel. 

Markers are clipped at the window edge in 41 1 2, 41 1 3, and 
41 1 5 terminals, and at the edge of terminal space in 41 1 4 
and 41 16 terminals. 

The DRAW-MARKER command has two formats: explicit 
and implicit. The explicit DRAW-MARKER command is E cLH 
xy. It does not depend upon or change the terminal's mode; 
it is executed as any other escape-sequence command. 

The implicit DRAW-MARKER command syntax is an xy 
when the terminal is In Marker mode. The ENTER- 
MARKER-MODE command (the F s character) puts the ter- 
minal into Marker mode. 



ERRORS 

LH1 1 (Level 2): Invalid marker-position (41 1 2, 41 1 3: X 

and Y both range from to 4095; 41 1 5: X 
and Y both range from -2 31 to 2 31 -1 ). 



REFERENCES 

ENTER-MARKER-MODE command 
SET-LINE-INDEX command 
SET-MARKER-TYPE command 
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DRAW-RECTANGLE Command 



4115 



Host Syntax 



E cUR xy-array.opposite-corners 



Setup Syntax 



E cUR s p opposite-corners 



PARAMETERS 

opposite-corners 

An xy-array containing pairs of xy coordinates. Each pair 
of xys represents opposite corners of a rectangle to be 
drawn and filled. In Coordinate mode 0, all coordinates 
are absolute. In Coordinate mode 1 , the first array coor- 
dinate is absolute and the following coordinates are rela- 
tive (see the SET-COORDINATE-MODE command). 



DESCRIPTION 

This command draws rectangular panels in terminal space. 
The actual action depends on whether a panel-boundary- 
definition is curently open. 

For each pair ofxy coordinates in the opposite-corners 
parameter, actions equivalent to the following commands 
are performed: 

BEGIN-PANEL-BOUNDARY: upper-right xy, 

draw-boundary-mode 
DRAW: lower-right xy 
DRAW: lower-left xy 
DRAW: upper-left xy 
DRAW: upper-right xy 
END-PANEL (see note) 



Draw-Boundary-Mode. The draw-boundary-mode is as set 
by the last SET-DRAW-BOUNDARY-MODE command. 



Beam Position. The final beam position after this command 
is the upper-right corner of the last rectangle drawn. 

NOTE 

If the DRAW-RECTANGLE command is issued 
within a panel-boundary-definition, the END- 
PANEL action is not performed for the last pair of 
xys. This allows the panel to be extended beyond 
the series of rectangles with MOVE, DRAW, and 
DRAW-MARKER commands. Also, if rectangles 
overlap, they behave as multiple boundaries to one 
panel. 

The rectangular panels are filled according to the most 
recent SELECT-FILL-PATTERN and SET-PANEL-FILLING- 
MODE commands. They are filled fastest if the fill pattern is 
negative, and, if in a segment, the image transform for the 
segment is the power-up default. 
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DEFAULTS 



REFERENCES 



opposite-corners 
as shipped — none 
on power-up — none 
if omitted — error UR1 1 



ERRORS 



BEGIN-PANEL-BOUNDARY command 
END-PANEL command 
SET-COORDINATE-MODE command 
SET-DRAW-BOUNDARY-MODE command 
SELECT-FILL-PATTERN command 
SET-PANEL-FILLING-MODE command 



UROO (Level 0): Unrecognized command. (Terminal is not 
a 41 15.) 

UR1 1 (Level 2): Invalid opposite-corners array. (There 
must be an even number of xys in the 
array. Each of these must range from -2 31 
to 2 31 -1 ; array length must be from to 
65535.) 

UR12 (Levei3): Out of memory while parsing parameter. 
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ENABLE-DIALOG-AREA Command 



Host Syntax 



E cKA \n\:enable-mode 



Setup Syntax 




PARAMETERS 



DESCRIPTION 



enable-mode (0 or 1 ). 

Specifies whether the dialog area is to be enabled or dis- 
abled. Setup mode parameters are YES and NO. 

NO; disables the dialog area. 

1 YES; enables the dialog area. 



If enable-mode is 1 , the dialog area is enabled. All alphatext 
is directed to the dialog area, at the position of the dialog 
area cursor. This occurs whether or not the dialog area is 
visible. (If the dialog area is invisible, the operator cannot 
see the alphatext being sent there.) 

If enable-mode is 0, the dialog area is disabled. Alphatext is 
directed to the graphics area, at the current graphic beam 
position. The graphic beam position is updated to point to 
the lower left corner of the alpha cursor. 

With the dialog area disabled, the terminal emulates more 
closely TEKTRONIX 4010-series terminals which do not 
have a dialog area. 

NOTE 

When ANSI code is selected (with the SELECT- 
CODE command), all alphatext goes into the dia- 
log area, reguardless of whether the dialog area is 
enabled or not. 



Table 7-9 lists the differences in terminal operation with the 
dialog area disabled and with it enabled. 
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DEFAULTS 



REFERENCES 



enable-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 



KA1 1 (Level 2): Enable-mode out of range. (Must be or 
1. In Setup mode, must be YES or NO.) 



c r character 

ENABLE-4010-GIN command 
ENTER-ALPHA-MODE command 
PAGE command 
RENEW-VIEW command 
SET-LINE-STYLE command 
SET-LINE-WIDTH command 
SET-MARGINS command 



Table 7-9 
FEATURES AFFECTED BY THE ENABLE-DIALOG-AREA COMMAND 



Feature 


Effect in Mode (Dialog Area Disabled) 


Effect in Mode 1 (Dialog Area Enabled) 


Destination 
for Alphatext 


Alphatext is directed to the current graphic beam position in 
terminal space. 


Alphatext is directed to the current alpha cursor position. 


PAGE Key, 
PAGE Command 


In the 41 1 2, 41 1 3, and 41 1 5, erases the viewport for the 
current view. In the 41 1 4 and 41 1 6, erases the screen. 

Redraws all visible segments. 

Removes the terminal from 4010 GIN mode. 

Resets line style to line style 1 . 

Resets 41 14 and 41 16 line width to 0. 

Moves the graphic beam to (0 ; 3071 ) in the 41 1 2 : 41 1 3, 41 1 4 : 
and 41 1 6. Moves the graphic beam to the Home position on 
a4115. 

In the 41 1 4 and 4116, puts margin number one in effect. 

Puts the terminal in Alpha mode. 


In the 41 12, 41 13, and 41 15, erases the viewport for the 
current view. In the 41 14 and 41 16, erases the screen. 

Redraws all visible segments. 


c r Character 


Puts the terminal in Alpha mode. 

Performs "carriage return" action in the graphics area. 

Resets line style to line style 0. 

Resets 41 1 4 and 41 1 6 line width to 0. 

Removes the terminal from 4010 GIN mode. 


If in Alpha mode, performs "carriage return" action for the 
alphatext cursor in the dialog area. 

If in Vector mode or Marker mode, does nothing. 
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ENABLE-GIN Command 



Host Syntax 



E clE int: device-function mtnumber-of-GIN-events 



Setup Syntax 



GINENABLE s p device-function number-of-GIN-events 



PARAMETERS 



device-function . 

A number of the form 8D + F, where D is a device code 
and F is a function code. Valid values for D are 
(thumbwheels), 1 (tablet), and 3 to 5 (RS-232 peripheral 
ports to 2). Valid values for F are (locator function), 
1 (pick function), and 2 (stroke function - valid only if 
D = 1). 



Enabies the GiN (graphic input) function on the specified 
device. The device and function are specified by the first 
integer. The second integer specifies how many events of 
the function are to occur before the function is automatically 
disabled. A function can be essentially enabled "perma- 
nently" by specifying a very large count (for instance, 
65535). 



number-of-GIN-events (0 to 65535). 

Specifies the number of points whose position will be 
reported in a GIN-report-sequence before the device- 
function combination is automatically disabled. If this 
parameter is 0, GIN is enabled for 65536 GIN events. 




If you want to simultaneously enable more than 
one device, use the ENABLE-GIN command. 
Undesired results may occur if the terminal is 
simultaneously enabled for graphic input with two 
different style enabling commands: ENABLE- 
GIN, ENABLE-4010-GIN, ENABLE-4953- 
TABLET-GIN. 
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The device-function combination is disabled when any of 
the following occurs: 

• The count specified in the ENABLE-GIN command 
expires. 

• The terminal receives a DISABLE-GIN command for that 
device-function . 

• The terminal receives a CANCEL command. 

• The operator presses the CANCEL key. 

With thumbwheel GIN enabled, pressing a key with a key- 
macro defined for it causes an event for each character in 
the macro which would normally be sent to the host. If the 
number of characters in the macro exceeds the number of 
remaining GIN events, the extra macro characters are sent 
to the host as a normal macro expansion. 

When the terminal sends a report to the host, bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 

Note that there are GIN devices and GIN functions. (See 
Tables 7-10, 7-11, and 7-12.) 



Table 7-10 
GIN DEVICE ID NUMBERS 



Table 7-11 
GIN FUNCTION ID NUMBERS 



Device 
Code 


Host Program 
Samples 


Event Device 





Thumbwheels 


Keyboard 


1 


Tablet 


Tablet pen or puck 


2 


Tablet 1 


Tablet pen or puck 


3 


Peripheral Port 


CALL button, if a 4662 plotter 
is assigned, or the POINT 
button if a 4663 plotter is 
assigned. 


4 


Peripheral Port 1 


Same as No. 3 


5 


Peripheral Port 2 


Same as No. 3 



Code 


Function 





Locator 


1 


Pick 


2 


Stroke 



Table 7-1 2 
DEVICE-FUNCTION ID CODE NUMBERS 



Code 


Device-Function Code 

(8 times device code plus function code) 





Thumbwheels-Locator 


1 


Thumbwheels-Pick 


8 


Tablet-Locator 


9 


Tablet-Pick 


10 


Tablet-Stroke 


24 


Plotter at Port - Locator 


25 


Plotter at Port - Pick 


32 


Plotter at Port 1 - Locator 


33 


Plotter at Port 1 - Pick 


40 


Plotter at Port 2 - Locator 


41 


Plotter at Port 2 - Pick 



The GIN devices are: 

• Thumbwheels. The operator uses the thumbwheels to 
position the graphic cursor and then signals a GIN event 
by pressing any ASCII key on the keyboard. 



NOTE 

If the terminal is in local mode (if the light in the 
LOCAL key is on), then pressing a keyboard key 
cannot signal a GIN event, even though GIN may 
be enabled with the thumbwheels as the GIN 
device. The reason is that in LOCAL mode charac- 
ters typed on the keyboard are treated as if they 
came from the host rather than the keyboard. 
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Tablet. (Requires Option 13 or Option 14.) The operator 
positions the graphic cursor by moving a stylus (or four- 
button cursor) over the graphic tablet. He signals a GIN 
event by pressing the stylus against the tablet, or by 
pressing a button on the tablet cursor. 

Peripheral ports. (Requires Option 10.) The operator 
positions the graphic cursor by moving the joystick on a 
TEKTRONIX 4662 or 4663 plotter connected to an 
RS-232 peripheral port. (This requires that Option 10, the 
Three Port Peripheral interface, be installed in the termi- 
nal.) The operator signals a GIN event by pressing a 
switch on the plotter. (On the 4662 plotter, this is the 
CALL switch; on the 4663, the POINT switch is used.) 

NOTE 

When graphic input is done from a plotter, the 
position on the screen of the graphic cursor is not 

updated until the operator signals a GIN event by 
pressing a switch on the plotter. 



NOTE 

Moving the thumbwheels or other GIN device 
positions the graphic cursor in GIN area space. 
However, the cursor which the operator actually 
sees is the image of the true cursor. How the visible 
image moves depends on the current GIN area/ 
GIN window and window /viewport transforms. 

In raster terminals, several points in terminal space 
can map to each pixel in raster memory space. 
Thus, when moving the thumbwheels slowly, it is 
possible to move the true cursor (whose position in 
terminal space is reported to the host) without 
producing any visible motion in the image of that 
cursor in raster memory space. 

Likewise, if the window in terminal space is very 
small (as when the operator has "zoomed in " to see 
more detail), then adjacent points in terminal space 
may have images in the current viewport which are 
separated by some small distance. In that case, as 
the operator moves the cursor in terminal space, 
the image of that cursor moves in short steps from 
place to place in raster memory space. 



The GIN functions are: 

• Locate. Returns x- and y-coordinates for a particular 
location. (This is the location in terminal space of the 
graphic cursor. For further information, see the GIN- 
locator-report description, elsewhere in this section.) 

• Pick. Compares all detectable segments within the pick 
aperture, returning the segment number and pick-i.d. of 
the highest-priority such segment, together with the xy 
coordinate of the graphics cursor. For further informa- 
tion, see the GIN-pick-report description, elsewhere in 
this section. 

• Stroke. Sends a continuous stream of x- and y-coordi- 
nates to the host. Currently only the graphics tablet can 
be used with the stroke function. For more information, 
see the GIN-STROKE-REPORT command. 



Example. To enable the graphics tablet for five events of the 
locator function: 

enable-GIN : tablet-locator, 5 events 
= E clE int:8 int: 5 
= EclESS 

Here the locator function on the graphics tablet is enabled 
for five events, after which the locator function is automati- 
cally disabled. 



Example. One may wish to enable a graphics function 
"permanently" — that is, until specifically disabled with a 
DISABLE-GIN command. To do this, one simply enables for 
a very large number of events (e.g., 32767). For instance: 

ENABLE-GIN : tablet-pick, 32767 events 
= *clE int:9 int:32767 
= e cIE9_ d t? 



Number Of GIN Events. The number-of-GIN-events 
parameter has a range from to 65535. (See the descrip- 
tion of the int parameter types for details.) This parameter 
specifies the number of GIN events for which the terminal is 
enabled. 

If this parameter is 0, the terminal is enabled for the 
maximum number of GIN events (65536). Otherwise, the 
terminal is enabled for the number specified by the int 
parameter. 
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DEFAULTS 

device-function 
as shipped — none 
on power-up — none 
if omitted — 

number-of-GIN-events 
as shipped — none 
on power-up — none 
if omitted — 65536 



IE03 (Level 2): Command is invalid at this time. (The 

segment being used as the cursor for the 
specified device-function is a segment 
which is currently being defined.) 

IE10 (Level 2): The specified GIN device is not installed 
in the terminal. 

IE13 (Level 2): The specified device is already enabled. 

IE21 (Level 2): Invalid number of GIN events. (Must be in 
the range from to 65535.) 



ERRORS 

1011 (Level 2): Invalid device-function. (See the descrip- 
tion for a table of device function codes.) 

IE00 (Level 2): The cursor segment for the specified 
device-function does not exist. (It has 
been deleted since the SET-GIN- 
CURSOR command which assigned it to 
that device-function). 



REFERENCES 

SET-GIN-AREA command 
SET-GIN-WINDOW command 
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DESCRIPTION 

This command is provided for compatibility with software 
written for earlier TEKTRONIX terminals. It provides an 
abbreviated way of enabling the thumbwheels for one GIN 
(graphic input) "locator" event. The report which the termi- 
nal sends in response to this GIN event is in the 4010-GIN- 
report format, rather than the GIN-report-sequence format 
used with the ENABLE-GIN command. 




If you want to simultaneously enable more than 
one device, use the ENABLE-GIN command. 
Undesired results may occur if the terminal is 
simultaneously enabled for graphic input with two 
different style enabling commands: ENABLE- 
GIN, ENABLE-4010-GIN, ENABLE-4953- 
TABLET-GIN. 

When the terminal receives an ENABLE-4010-GIN 
command — the sequence of characters e c s b - it displays 
the graphic cursor assigned to device-function zero. (The 
default cursor is the crosshair cursor; however, this may be 
changed with the SET-GIN-CURSOR command.) 

The operator may then position the cursor by moving the 
thumbwheels. (The possible cursor positions are deter- 
mined by the most recent SET-GIN-GRIDDING command 
for device-function zero — thumbwheels device, locator 
function.) 



When the cursor is at the desired location, the operator 
presses any of the ASCII keys on the keyboard; this signals 
a "GIN event." In response to this GIN event, the terminal 
sends a 4010-GIN-report. That report tells the host (a) 
which key the operator pressed, and (b) the location of the 
crosshair cursor in the terminal space. 

When 4010 GIN is enabled, pressing a key which has a 
key-macro defined for it will cause an event for the first char- 
acter of the macro which would normally be sent to the host. 
The remainder of the macro is expanded normally. 

When the terminal sends a report to the host, it enters 
Bypass mode. (See ENTER-BYPASS-MODE.) 

After sending the 4010-GIN-report, the 41 1 sets its 
graphic beam position to the position of the graphics cursor, 
and enters Alpha mode. This is done for compatibility with 
TEKTRONIX 401 Series terminals. 

If the dialog area is not enabled, then receiving a c r 
character, or a PAGE command, cancels the effect of the 
ENABLE-4010-GIN command and places the terminal in 
Alpha mode. Pressing the PAGE key has the same effect as 
the PAGE command. For details, see the description of the 
ENABLE-DIALOG-AREA command. 

If the dialog area is enabled, then the PAGE key, the PAGE 
command, and the c r character have no effect on graphic 
input; they do not cancel the effect of the ENABLE-401 0- 
GIN command. 
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Terminal Settings For Emulating 4010-Series Graphic 
Input. To properly emulate a TEKTRONIX 401 0-series 
terminal during graphic input, several of the terminal's set- 
tings must be set a certain way. The exact settings may vary 
from one computer installation to another. Table 7-13 lists 
settings which should work for most host computers. 



Set the bypass-cancel-char Xo whatever is the last character 
which the host echoes in response to a report message 
from the terminal. If the host is not echoing characters sent 
from the terminal, set the bypass-cancel-char Xo N u. If the 
host echoes c r as c r l f, set the bypass-cancel-char to l f. If the 
host echoes c r as exactly c r, set the bypass-cancel-char Xo 



Table 7-13 

TERMINAL SETTINGS TO EMULATE 
4010-SERIES GRAPHIC INPUT 



Escape-Sequence Command 


Equivalent Setup 
Mode Command 


SET-REPORT-EOM-FREQUENCY: 1 
= E clM1 


REOM1 


SET-EOM-CHARS: 0, 
= E cNC00 


EOMCHARS 


SET-EOL-STRING: c r 
= E cNT 

int-array: 13 
= E cNT1 = 


EOLSTRING c r 


SET-BYPASS-CANCEL-CHAR 
= E cNU 

int: bypass-cancel-char 


BYPASSCANCEL c r 
BYPASSCANCEL N u 
BYPASSCANCEL l f 



REFERENCES 

4010-GIN-report syntactic construct 
ENABLE-GIN command 
SET-EOL-STRING command 
SET-EOM-CHARS command 
SET-GIN-CURSOR command 
SET-GIN-GRIDDING command 



7-84 



41 10 SERIES COMMAND REFERENCE 



TEK COMMANDS 



ENABLE-4953-TABLET-GIN Command 



OPTIONS 13 AND 14 



Host Syntax 



E c! char.enable-code 



PARAMETERS 

enable-code. 

A seven-bit ASCII character whose five least-significant 
bits hold tablet control information. If the fourth least- 
significant bit in the character is 1 , the second least- 
significant bit must be 1 as well. 

DESCRIPTION 

This command is provided for (partial) compatibility with 
software written for earlier TEKTRONIX terminals. When 
graphic input is enabled with this command (rather than the 
ENABLE-GIN command), the 41 10 emulates a TEKTRONIX 
401 Series terminal equipped with a TEKTRONIX 4953 or 
4954 Graphics Tablet. Also see the SET-TABLET-SIZE 
command. 

This command is only available if the 4110 terminal is 
equipped with an accessory graphics tablet (Option 1 3 
or Option 14). 



Enable-Code. The enable-code parameter is a seven-bit 
ASCII character whose least-significant bits hold control 
information for the tablet, as follows: 

b7 b6 b5 b4 b3 b2 b1 



X X d d d 



X 



where 




Undesired results may occur if the terminal is 
simultaneously enabled for graphic input with two 
different enabling commands. Do not use more 
than one of these commands at the same time: 
ENABLE-GIN, ENABLE-4010-GIN, ENABLE- 
4953-TABLET-GIN. 



X = "don't care" (may be zero or one) 

d = data (control information for the tablet) 

b7, b6: "Don't cares." 

b5: Bit b5 controls whether the 41 1 is to return 

10-bit or 12-bit coordinate data to the host. If 
this bit is zero, then x- and y-coordinates which 
the terminal sends to the host will each include 
only 1 binary data bits. If this bit is one, then 
the x- and y-coordinates reported to the host will 
each include 1 2 data bits. (For details, see the 
description of the 4953-tablet-GIN-report.) 

b4: Bit b4 determines the effect of lifting the pen (or 

four-button tablet cursor) away from the tablet. 
(This is called "removing the pen from pres- 
ence.") If this bit is 1 , then lifting the pen out of 
presence disables the tablet, as if a DISABLE- 
4953-TABLET-GIN command were received. If 
bit b4 is 0, then lifting the pen out of presence 
does not disable the tablet. 
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b3, b2: For 401 Series terminals equipped with the 
4953 or 4954 graphics tablets, bit b3 is the 
"presence" bit, and bit b2 is the "multiple- 
point" bit. In the 41 10 terminal, these bits may 
perhaps best be explained by saying that they 
together determine which 4110 enable-GIN 
command most closely resembles this enable- 
4953-tablet-GIN command: 

b3 b2 Function 

Analogous to an enable-GIN command 
for the tablet device, locator function, 
and one GIN event. 

1 Ana!o n ous to an enable-GIN com- 

mand for the tablet device, locator 
function, and 65535 GIN events. 

1 Analogous to an enable-GIN command 

for the tablet device, locator function, 
and one GIN event. 

1 1 Analogous to an enable-GIN command 
for the tablet device, stroke function, 
and 65535 GIN events. 

b1 : In a 401 Series terminal equipped with a 4953 

graphic tablet, bit b1 determines whether the 
terminal is to display locally the position data 
which is being sent to the host computer. The 
41 10 always assumes that this bit is 1 , causing 
the terminal to display the graphic cursor. If the 
"stroke" function or "multi-point locator func- 
tion" is enable (bit b2 set to one), then the 41 1 
performs "inking," as if a SET-GIN-INKING 
command had been issued. 



After the Report is Sent. If the terminal is enabled for 
single-point GIN (that is, if the enable-code's bit b2 is zero), 
then it sends a single 4953-tablet-GIN-report to the host. 
After sending this report, the 41 10 enters alpha mode. On 
entering alpha mode, the alpha cursor's lower left corner is 
at the point whose position was just reported to the host in 
the 4953-tablet-GIN-report. 

Likewise, if the terminal is enabled for multiple-point GIN 
(that is, if the enable-code's bit b2 is one), then it enters a 
graphic input mode and can send many 4953-tablet-GIN- 
reports to the host. It exits this graphic input mode on 
receiving a DISABLE-4953-TABLET-GIN command or a 
CANCEL command, when 65535 points have been sent to 
the host (i.e., the report count has been satisfied), or when 
the the CANCEL key is pressed. When this occurs, the 
terminal enters alpha mode, and the alpha cursor is at the 
last point whose position was reported to the host. 



Emulating 4953/4954 Strap Settings 

As mentioned before, the purpose of the enable-4953- 
tablet-GIN command is to let the 41 10 terminal emulate an 
earlier TEKTRONIX 4010-series terminal with an accessory 

4953 or 4954 graphics tablet. However, to do this correctly, 
the 41 1 must emulate certain strap settings on the 4953/ 

4954 Tablet Control Board . 

Table 7-1 4 lists the 4953/4954 Tablet Control Board strap 
settings, together with the commands for the 41 1 which 
emulate these strap settings. Before using a 41 10 with an 
existing program designed for the 4953/4954 graphics 
tablet, you should first issue the appropriate commands 
from this table. 



Also, If a tablet overlay is used with the existing applications 
program, then you should issue a SET-TABLET-SIZE: 1 
command. This reduces the tablet's active area, so that 
overlays developed for Tektronix 4953 and 4954 tablets can 
be used with the terminal's Option 1 3 and 14 tablets. 
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Emulating Other 401 0-Series Terminal Settings ERRORS 



Besides the settings which emulate straps on the 4953/ 
4954 Tablet Control Board, there are certain other terminal 
settings which must be set to emulate 4010-series graphics 
terminals. Please refer to Table 7-1 3, in the description of 
the ENABLE-4010-GIN command. 



Table 7-14 
EMULATING 4953/4954 STRAP SETTINGS 



Strap 


Strap 
Setting 


Equivalent 41 1X Commands 


CR 


IN 


SET-REPORT-EOM-FREQUENCY: 1 
SET-EOL-STRING:(13) 




OUT 


SET-REPORT-EOM-FREQUENCY: 
St l-RtPOhi i-MAX-LiNE-LENG i H: 


HEADER 


CONTROL 


SET-TABLET-HEADER-CHARACTERS:1 




LETTER 


SET-TABLET-HEADER-CHARACTERS:0 


LARGE/ 
SMALL 




The terminal automatically emulates this 
strap. That is, the terminal automatically 
determines whether the small tablet 
(Option 1 3) or the large tablet (Option 
14) is attached. 


DELAY 


IN 


SET-TRANSMIT-DELAY: 25 
orSET-TRANSMIT-DELAY: 50 




OUT 


SET-TRANSMIT-DELAY: 


ESUP 




In the 41 10 terminal, echo suppression 
is handled by the "bypass mode" 
associated with GIN. There is no need to 
emulate the ESUP (echo suppression) 
Strap. 


COMSUP 




The 41 10 terminal always emulates the 
IN position of the COMSUP strap. 


STATUS 


IN 


SET-TABLET-STATUS-STRAP: 1 




OUT 


SET-TABLET-STATUS-STRAP: 



1100 (Level 0): Unrecognized command (Option 13 or 14 
not installed). 



REFERENCES 

TEKTRONIX 4953/4954 Graphics Tablet Instrucion 

Manual 
DISABLE-4953-TABLET-GIN command 
ENABLE-GIN command 
SET-GIN-INKING command 
SET-TABLET-SIZE command 
4010-status-report syntactic construct 
4953-tablet-GIN-report syntactic constuct 
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END-FILL-PATTERN Command 4112, 41 13, 41 15 

Host Syntax 




Setup Syntax 




DESCRIPTION REFERENCES 

This command terminates aftll-pattern-dejlnition. The BEGIN-FILL-PATTERN command 

remainder (if any) of the fill pattern rectangle is filled with Fill-pattern-definition syntactic construct 

index 0. 

ERRORS 

MEOO (Level 0): Unrecognized command (terminal is not a 
4112, 4113, or4115). 
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END-GRAPHTEXT-CHARACTER Command 

Host Syntax 




Setup Syntax 




DESCRlP I ioN REFERENCES 

Terminates the graphtext character currently being defined. BEGIN-GRAPHTEXT-CHARACTER command 

ERRORS 

SU03 (Level 1 ): This command is invalid at this time. (No 
graphtext character is being defined.) 
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END-PANEL Command 



4112,4113,4115 



Host Syntax 




Setup Syntax 




DESCRIPTION 



ERRORS 



This command terminates a panel-definition. The current 
panel boundary is closed, setting the graphic beam position 
to first-point of the panel boundary (that is, the coordinate 
specified in the last BEGIN-PANEL-BOUNDARY com- 
mand). 

If the current fill pattern number (as specified by the most 
recent SELECT-FILL-PATTERN command) is greater than 
-8 (in the 41 1 2), -1 5 (in the 41 1 3), or -256 (in the 4115), and 
that fill pattern exists, then the panel interior is filled with 
that fill pattern. The fill occurs in Overstrike or Replace 
mode according to the "overstrike/replace" parameter in 
the most recent SET-PANEL-FILLING-MODE command. 



LEOO (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

LE03 (Level 1 ): No panel is currently being defined. 

LE02 (Level 3): Out of memory while performing END- 
PANEL command. 



REFERENCES 

BEGIN-FILL-PATTERN command 
BEGIN-PANEL-BOUNDARY command 
END-SEGMENT command 
Panel-definition syntactic construct 
SELECT-FILL-PATTERN command 
SET-PANEL-FILLING-MODE command 
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END-SEGMENT Command 



Host Syntax 




Setup Syntax 



E cSC 



DESCRIPTION 

If a segment is currently being defined, this command 
terminates that segment definition. If a panel is currently 
being defined within the segment, that panel-definition is 
also terminated, as if an END-PANEL command had been 
received. 

In the 41 1 2, 41 1 3, and 41 1 5, the view which is selected at 
the time of the END-SEGMENT command is the view in 
which the segment is made visible. (Unless a SET- 
SEGMENT-VISIBILITY command for "segment -2" has 
determined that newly-created segments are to be invisible, 
or that is to be visible in more than one view.) 



ERRORS 

SC02 (Level 3): Out of memory while performing END- 
SEGMENT command (41 1 2, 41 1 3, and 
41 15 only). 

SC03 (Level 1): Invalid at this time: no segment is 
currently being defined. 

REFERENCES 

BEGIN-HIGHER-SEGMENT command 
BEGIN-LOWER-SEGMENT command 
BEGIN-NEW-SEGMENT command 
BEGIN-SEGMENT command 
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ENTER-ALPHA-MODE Command 



Host Syntax 




DESCRIPTION 

This command puts the terminal in Alpha mode. 

While the terminal is in Aipha mode, it interprets any ASCIi 
characters it receives (except those comprising commands) 
as text to be displayed; i.e., alphatext. If the dialog area is 
enabled, this "alphatext" is sent there. 

If the dialog area is disabled when this command is 
received, the current beam position is moved to y = 3071 
ona4112,4113,4114, and 4116, and to the Home position 
on a 41 15 if it was higher. If the current beam position is 
lower than y = 3071 on a 41 1 2, 41 1 3, 41 1 4, and 41 1 6, and 
to the Home position on a 41 15, it is not changed. 

In the 41 14 and 41 16, if the dialog area is not enabled, then 
alphatext is directed to the screen, where it is written in 
storage mode. 

In the 41 12, 41 13, and 4115, the dialog area is not enabled, 
alphatext is directed to the current view, at the current 
graphic beam position in terminal space. (If this location 
falls outside the current view's window, then the alphatext 
does not appear in the current viewport.) 



The terminal leaves alpha mode on receiving an ENTER- 
VECTOR-MODE or ENTER-MARKER-MODE command. 

On the 41 14 and 41 1 6, alphatext may appear in any of a 
variety c> CtiaractGr sizes, acccruing to tns most recent 
SET-ALPHA-TEXT-SIZE or SET-4014-ALPHATEXT-SIZE 
command. 

If Option 4E is installed on a 41 1 2, 41 1 3, 41 1 4, or 41 1 6 ter- 
minal, the alphatext may also appear in the APL character 
font; this is controlled by the SET-ALPHATEXT-FONT 
command. 

If Option 4K is installed, the alphatext may also appear 
in the Katakana character font; this is controlled by the 
SET-ALPHATEXT-FONT command and the BREAK key. 

In Alpha mode, a carriage return c r moves the cursor to the 
beginning of the current line — unless a CRLF: YES has 
been issued. In that case, c r moves the cursor to the 
beginning of the next line. 

In Alpha mode, a line feed l f moves the cursor down one 
line, but at the same line position — unless a LFCR: YES 
command has been issued. In that case, the l f moves the 
cursor to the beginning of the next line. 
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When a segment is being defined and the dialog area is 
disabled, the "wrap-around" features of alphatext are 
disabled. When the next character to be displayed would 
end past x = 4095 on a41 12, 41 13, 41 14, or 41 16 or the 
overview window right boundary on a 41 1 5, it is not dis- 
played and the cursor position is left unchanged. Similarly, a 
B s character is not processed if the resulting x-position 
would be less than zero on a 41 1 2, 41 1 3, 41 1 4, or 41 1 6 or 
the overview window left boundary on a 41 1 5. An l f is not 
processed if the resulting y-coordinate would be less than 
zero on a 41 1 2, 41 1 3, 41 1 4, or 41 1 6 or the overview window 
bottom on a 41 15, and a v t is not processed if the resulting 
y-coordinate would be greater than 3071 on a 41 1 2, 41 1 3, 
41 1 4, or 41 1 6 or the Home position on a 41 1 5. The 41 1 5 
overview window and Home position are discussed within 
the SET-OVERVIEW-WINDOW command description. 



REFERENCES 

CRLF command 
c r character 

ENABLE-DIALOG-AREA command 
ENTER-MARKER-MODE command 
ENTER-VECTOR-MODE command 
l f character 
LFCR command 
PAGE command 

SET-ALPHATEXT-SIZE command 
SET-ALPHATEXT-FONT command 
SET-OVERVIEW-WINDOW command 
SET-4014-ALPHATEXT-SIZE command 



The ENTER-ALPHA-MODE command (that is, the u s char- 
acter) also terminates any command which precedes it. This 
is described in Section 2, under the heading "Commands of 
More Than Three Characters." 
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ENTER-BYPASS-MODE Command 



Host Syntax 




DESCRIPTION 

The terminal includes a Bypass mode, in which characters 
coming from the host are ignored until a special bypass- 

for use when the terminal is sending report messages to the 
host. (Without Bypass mode, a host which provides a 
remote echo could cause problems, as the echoed charac- 
ters would be received by the terminal and executed as 
commands.) 

However, there are circumstances when it may be helpful 
for the terminal to enter bypass mode even though the 
terminal is not sending a report to the host. The ENTER- 
BYPASS-MODE command provides this facility. 

For instance, in full duplex remote echo data communica- 
tions, the host can issue an ENTER-BYPASS-MODE 
command to temporarily suppress the host's remote echo 
while the operator types in a password. 



Entering Bypass Mode. The terminal enters Bypass mode 
when it receives an ENTER-BYPASS-MODE command. The 
terminal does not enter Bypass mode until the command 
has been processed, which takes at least 25 milliseconds, 
lonner if timp-consuminfi commands Tecede this 
command in the command queue. 

The terminal also enters bypass mode when it sends the 
first character of each line of a report to the host computer 
— except for messages typed by the operator. For this pur- 
pose, "the first character of each line" means "the first 
character of the message, or the first character following an 
EOM-indicator or EOM-char within the message." 

For instance: 

• If the terminal is sending EOM-indicators after each 
GIN-report within a GIN -report-sequence (that is, if 
the REPORT-EOM-FREQUENCY setting is "more 
frequent"), then the terminal enters bypass mode as it 
sends the sig-char that precedes each GIN-report in the 
GIN-report-sequence. (See the description of GIN- 
report-sequence for details.) 

• If the terminal is executing a copy from a disk file to the 
host computer, then it enters bypass mode on sending 
the first character of that file to the host. If the file con- 
tains EOM-chgrs (such as c r characters, for instance), 
then the terminal enters bypass mode again as it sends 
the first character after each EOM-char. 
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Exiting Bypass Mode. The terminal exits bypass mode 
when it receives the current bypass cancel character, 
as set by the most recent SET-BYPASS-CANCEL-CHAR 
command. (It also exits bypass mode in response to the 
cancel command or the CANCEL key.) 

For instance, suppose that the current EOM-char is c r; that 
the current EOL-string consists of the single character, c r; 
and that the host computer echoes each c r as c r l f. 

Then as the terminal sends each line of text to the host, the 
last character in each line sent to the host is c r, and the last 
character in the echo of each such line is l f. The l f charac- 
ter, then, should be selected as the bypass-cancel-char. 



NOTE 

If the current bypass-cancel-char is N u, then the 
bypass mode feature is disabled. In that case, the 
ENTER-B YPASS-MODE command has no effect. 



REFERENCES 

SET-BYPASS-CANCEL-CHAR command 
GIN-report-sequence message type 
COPY command 



As the terminal sends the first character of each line of a 
report or file to the host, it enters bypass mode. In bypass 
mode, the terminal ignores the characters which the host 
echoes back to it. The last character in the echo, l f, is the 
bypass-cancel-char and removes the terminal from bypass 
mode. 
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ENTER-MARKER-MODE Command 



Host Syntax 




DESCRIPTION 

The ENTER-MARKER-MODE command places the terminal 
in Marker mode. Once in Marker mode, subsequent 
alphanumeric characters are interpreted as xy parameters 
specifying coordinates at which markers are to be placed. 
Each xy coordinate received in Marker mode not only 
causes a marker to be drawn, but also updates the graphic 
beam position. Markers are drawn in the current line index, 
as set by the most recent SET-LINE-INDEX command. 



The ENTER-MARKER-MODE command (that is, the 
F s character) also terminates any command which precedes 
it. This is described in Section 2, under the heading "Com- 
mands of More Than Three Characters." 

If the terminal is in Marker mode and a BEGIN-PANEL- 
BOUNDARY command is received, xy coordinates received 
until the panel-boundary-definition is ended are interpreted 
as vertices of the panel boundary, and markers are not 
displayed. 



Markers are clipped at the window edge on 41 12, 41 13, and 
4115 terminals, and at the edge of terminal space on 41 1 4 
and 41 1 6 terminals. 

The terminal leaves Marker mode on entering Alpha mode. 

While in Marker mode, the ENTER-VECTOR-MODE 
command has no effect. (To go from Marker mode to Vector 
mode, you must first place the terminal in Alpha mode.) 



REFERENCES 

BEGIN-PANEL-BOUNDARY command 
DRAW-MARKER command 
SET-MARKER-TYPE command 
XY parameter type 
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ENTER-VECTOR-MODE Command 



Host Syntax 




DESCRIPTION 



REFERENCES 



The ENTER-VECTOR-MODE command places the terminal 
in Vector mode and sets the move/draw flag to move. Once 
in Vector mode, subsequent characters are interpreted as 
xy parameters, which in turn are interpreted as implicit 
MOVE or DRAW commands (depending on the setting of 

+h^ m/MiA/rlroiAf tl*irt\ Aftor q imnli^it MfiX/F c\r HRAW the 

move/draw flag is set to draw. 

The ENTER-VECTOR-MODE command (that is, the G s 
character) also terminates any command which may 
precede it. This is described in Section 2, under the heading 
"Commands of Three or More Characters." 



DRAW command 
MOVE command 
SET-LINE-STYLE command 
SET-4014-LINE-STYLE command 
XY parameter type 
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EOF-String Syntactic Construct 

DESCRIPTION REFERENCES 

The EOF-string (end-of-f ile string) is a sequence of zero to 4110 Series Host Programmer's Manual 

ten ASCII characters. It is used in host/terminal file transfer ARM-FOR-BLOCK-MODE command 

operations to mark the end of a file. If the terminal is in block SET-EOF-STRING command 
mode, the end-of-file bit in the block-control-bytes is used 
instead of the EOF-string. 

NOTE 

When the terminal is armed for block mode or in 
block mode, it does not detect EOF-string.? coming 
from the host computer. Therefore, if you are not 
using block mode, you should be sure that the ter- 
minal is not armed for block mode. 

See the 4110 Series Host Programmer's Manual for details 
on file transfers. 
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EOL-String Syntactic Construct 

DESCRIPTION REFERENCES 

The EOL-string (end-of-line string) is a sequence of zero, 41 10 Series Host Programmer's Manual 

one, or two ASCII characters which are automatically added EOM-indicator syntactic construct 

to the end of a line in reports and blocks which the terminal SET-EOL-STRING command 

sends to the host computer. SET-EOM-CHARS command 

The terminal inserts EOM-indicators at specific points in 
the reports it sends to the host. Each EOM-indicator marks 
the end of a line of text being sent to the host. If the terminal 
is not in block mode, the EOM-indicator is sent as an EOL- 
string. If in block mode, a different mechanism is used; see 
the EOM-indicator description for details. 

See the 4110 Series Host Programmer's Manual for details 
on the use of the EOL-string. 
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EOM-lndicator Syntactic Construct 

SYNTAX 



EOM-indicator = (EOL-string \ 

I block-end-of-message I 



DESCRIPTION REFERENCES 

EOM-indicators are uses by the terminal to terminate 4110 Series Host Programmer's Manual 

reports and to break long reports into shorter segments. Aii Block-control-by ies syntactic construct 

reports from the terminal end with an EOM-indicator, SET-BLOCK-PACKING command 

SET-EOM-CHARS command 

As the terminal sends reports, it counts the characters. SET-REPORT-EOM-FREQUENCY command 

When the count reaches the current report-max-line-length, SET-TRANSMIT-DELAY command 
the terminal inserts an EOM-indicator. The terminal always 
sends report units such as int-reports and xy-reports in 
their entirety between EOM-indicators. 

If the terminal is not in block mode, then it sends the current 
EOL-string as each EOM-indicator. Having sent the EOL- 
string, the terminal pauses for the current transmit delay 
before sending the first character of the next line. 

In block mode, the terminal terminates the current block 
and sets the end-of-message bit in the block-control-bytes 
for each EOM-indicator. 

See the 4110 Series Host Programmer's ManuaHor details 
on the uses of EOM-indicators. 
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Error-Report Message Type 



SYNTAX 



error-report 



[report-for-one-error. . .] 

[term-sig-char] 

EOM-indicator 



report-for-one-error = 



error-code-report = 



[sig-char] 
error-code-report 
int-report: severity-level 
int-report: error-count 
[EOM-indicator] 

char-report: first-command-char 
char-report: second-command-char 
char-report: parameter 
char-report: error-type 



DESCRIPTION 

The terminal sends an error-report message in response to 
a REPORT-ERRORS command. In that error-report, there 
is one report-for-one-error message for each of the eight 
most recently detected error codes. If fewer than eight 
errors have been detected since power-up or since the last 
REPORT-ERRORS command then there are fewer than 
eight reports-for-one-error in the error-report message. 

by the SET-REPORT-SIG-CHARS command. After the last 
report-for-one-error, the terminal sends a term-sig-char and 
an EOM-indicator, this signals the end of the error-report 
message. 



The terminal does not send a signature character if it is the 
N u character. Do not set the sig-char or term-sig-char to N u, 
since lack of a signature character makes it difficult for the 
host to parse the error-report message. 

Besides the sig-char, each report-for-one-error includes a 
four-character error code, a severity level number, and the 
number of times the terminal has detected that error since 
power-up or the last REPORT-ERRORS command. The 
error codes and severity levels are described in Appendix C. 



REFERENCES 

Appendix C, "Error Codes" 
REPORT-ERRORS command 
SET-REPORT-SIG-CHARS command 
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E c Character 

DESCRIPTION REFERENCES 

The ASCII "escape" character - E c - is used to signal the "Command Syntax," in Section 2 

terminal that the next few characters comprise a command 
for it. When this character begins a command, it also termi- 
nates any command currently being sent to the terminal. 
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Setup Syntax 



E cKX int: macro-number 



PARAMETERS 

macro-number (-32768 to -32742, -32740 to -32737, 
-32608 to -3251 3, and to 32767) 
The number of the macro whose definition is being 
invoked. 



DESCRIPTION 

The EXPAND-MACRO command causes the terminal to 
insert into its current input data stream the contents of a 
macro definition. It is a companion command to the 
DEFINE-MACRO command, which defines a macro. 

If the EXPAND-MACRO command comes from the host 

tJUl I ipULCI, II IO II CGUCU uy li lO ici n ill i«i a5 ■■ mvi n-»S* wUm 

puter had sent the contents of the macro which is being 
expanded. 

If the EXPAND-MACRO command comes to the terminal 
from a disk file which is being loaded, it is treated by the 
terminal as if the disk file had included the contents of that 
macro. 

If the EXPAND-MACRO command is entered from the key- 
board while the terminal is in Local or Setup mode, the 
macro contents are treated as input from the keyboard. 



Any macro which is being expanded may contain byte- 
macros or other expand-macro commands. (Information 
on byte-macros can be found in the DEFINE-MACRO com- 
mand description.) Commands may be nested this way to a 
nesting depth limited only by the number of defined macros. 
However, if one of these commands attempts to expand a 
macro which is currently being expanded at a higher nest- 
ing level, the command is not executed; that is, recursion 
does not occur in macro expansions. 

The rest of this description discusses how the three types of 
macros can be expanded. 



Byte-macros. Byte-macros are expanded when the 8-bit 
ASCII character that corresponds to the byte-macro's 
macro-number is received by the terminal's command 
processor or the macro-number is included as the macro- 
number parameter of the EXPAND-MACRO command. The 
character may come from the host, from the keyboard when 
the terminal is in ECHO YES or Local mode, or from the 
data stream that results from a LOAD command. 

Byte-macros are expanded in Setup mode only if they are 
included as the macro-number parameter of the EXPAND- 
MACRO command. If the character to which the byte-macro 
corresponds is typed on the keyboard (without an EXPAND- 
MACRO command), the byte-macro is not expanded. 

Any character within the byte-macro's macro-contents 
which corresponds to a byte-macro is also expanded 
(because that character is received by the command 
processor). Any EXPAND-MACRO command in the macro- 
contents expands the appropriate key- or host-macro, 
including any byte-macros that are part of the keyor host- 
macro expansion. 
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While a byte-macro is being expanded, the byte to which 
it corresponds is no longer recognized as having a byte- 
macro definition (unmapped) for as long as it takes to 
complete the expansion. This prevents the occurrence of an 
infinite loop. Once the macro is fully expanded, the byte is 
again recognized as a byte-macro (remapped). 

If macros are nested, each byte-macro is unmapped and 
remapped each time its expansion is begun and finished, so 
that there may be more than one expansion of a byte-macro 
within another macro so long as that individual byte-macro 
is not nested within itself.ln other words, recursive macro 
expansion is not allowed. 

To access the byte-macros corresponding to the 8-bit ASCII 
values 160 through 255 (macro-numbers -32608 through 
-3251 3), you must use either 8-bit packing in block mode, 
or data parity with control over the eighth bit so that you can 
send the corresponding characters to the terminal 
command processor. 



Key-macros. Key-macros are expanded with the EXPAND- 
MACRO command or by pressing the key (or combination of 
keys) on the terminal keyboard to which the macro corres- 
ponds. The expansion of key-macros cannot be nested, 
since the terminal cannot press one of it's own keys. 

When a key-macro is expanded with an EXPAND-MACRO 
command received from the host, or from the keyboard 
when the terminal is in ECHO YES or Local mode, any 
EXPAND-MACRO commands or byte-macros in its contents 
are expanded as if they came from the host. 

When a key-macro is expanded by its corresponding key- 
stroke^), and Setup mode is disabled and the terminal is 
not in Local mode, the macro-contents are sent to the host 
communication port as if the they had been entered at the 
keyboard. You may use the key-execute-character within a 
key-macro's macro-contents to toggle the flow of the macro- 
contents back and forth between the terminal's command 
processor and the host communication port. This method 
only works if the key-macro was expanded by a keystroke 
and the terminal is not in Setup mode. If Local mode or local 
echo are enabled, the contents, including the key-execute- 
character, are sent to the command processor, so that any 
EXPAND-MACRO commands or byte-macros in the 
contents are treated as if they had come from the host. 

When a key-macro is expanded while Setup mode is 
enabled (either with keystroke(s) or with the expand-macro 
command), all characters within the macro-contents are 
treated as if they had been typed into the keyboard with 
Setup mode enabled, including EXPAND-MACRO and other 
terminal commands. 



EXPAND-MACRO commands or keystrokes for macros that 
are already being expanded are ignored. Recursive macro 
expansions are not allowed. 

With thumbwheel GIN enabled, pressing a key with a macro 
defined for it will cause a GIN event for each character in 
the macro which would normally be sent to the host (see the 
ENABLE-GIN command). 

Host-macros. Host-macros are expanded with the 
EXPAND-MACRO command. 

If the EXPAND-MACRO command is received from the host 
or while the terminal is in Local mode, any byte-macros 
within the macro-contents are expanded (unless they are 
already being expanded), as are any EXPAND-MACRO 
commands. 

EXPAND-MACRO commands for macros that are already 
being expanded are ignored. Recursive macro expansions 
are not allowed. 

If the EXPAND-MACRO command is entered when the 
terminal is in SETUP mode, the contents of the specified 
macro are treated as if they had been typed on the keyboard 
while the terminal was in Setup mode. 



DEFAULTS 

macro-number 
as shipped — none 
on power-up — none 
if omitted — 



ERRORS 

KX11 (Level 2): Invalid macro-number (must be -32768 
to -32742, -32740 to -32737, -32608 to 
-3251 3, and to 32767). 

REFERENCES 

DEFINE-MACRO command 
ENABLE-GIN command 
Key-execute-character syntactic construct 
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Fill-Pattern-Definition Syntactic Construct 



4112,4113,4115 



SYNTAX 



fill-pattern-definition = 



BEGIN-FILL-PATTERN 

\pixel-def...] 

[END-FILL-PATTERN] 



pixel-def = RUNLENGTH-WRITE or RASTER-WRITE 



DESCRIPTION 

To define a fill pattern (for later use in filling panels): 

1 . Issue a BEGIN-FILL-PATTERN command. 

2. Issue one or more RASTER-WRITE and/or 
RUNLENGTH-WRITE commands to specify the 
content of the fill-pattern rectangle as a matrix of color- 
indices. 

3. Issue an END-FILL-PATTERN command to explicitly 
terminate a Fill-pattern-definition before defining all 
indices in the pattern rectangle. The remaining indices 
default to index 0. (This command is ignored if the 
RASTER-WRITE or RUNLENGTH-WRITE operations 
filled the fill-pattern rectangle.) 

When enough indices are received to fill the fill-pattern rec- 
tangle, the Fill-pattern-definition is implicitly ended. If more 
color-indices then are needed are received within the final 
RASTER-WRITE and RUNLENGTH-WRiTE command, the 
extras are discarded. 



REFERENCES 

BEGIN-FILL-PATTERN command 
END-FILL-PATTERN command 
RASTER-WRITE command 
RUNLENGTH-WRITE command 
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FORMAT-VOLUME Command 



OPTIONS 42, 43, AND 45 



Host Syntax 



E cJF dev\ce:disk-drive-and-information 



Setup Syntax 



FORMAT s p disk-drive-and-information 



PARAMETERS 

disk-drive-and-information 

This parameter has two parts: disk-drive and informa- 
tion. Disk-drive specifies the drive on which the disk you 
want to format is mounted. Recognized disk-drives are: 

FO: the Option 42 and 43 disk drives. F1 : 

F1: 

SO: — Z7: the Option 45 disk drives. 

Include the information part of the parameter immedi- 
ately after the final character (:) of the disk-drive part only 
if disk-drive specifies an Option 45 device. Valid entries 
for information are: 

/C formats the d isk f or 8 Megabytes for 

compatibility with Local Programmability. 

/1 to /65535 identifies a bad track number. 



DESCRIPTION 

The FORMAT-VOLUME command formats a disk on the 
specified disk drive. Formatting is necessary before using a 
disk and includes verifying which areas of the disk are good 
and building a directory. 

If a previously formatted disk is used (re-formatted), any 
directories and files on that disk volume are wiped out and 
their space is used for the new directory and files. 

If you specify FO: or F1 : for the device, the disk in the device 
is formatted with 320 directory entries. If you specify one of 
the Option 45 devices, the disk is formatted with a number 
of directory entries according to the capacity of the device 
attached: 

to 67 megabytes: 4096 entries 

67 to 124 megabytes: 8192 entries 
124 to 268 megabytes: 16384 entries 
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Enter the second part of the disk-drive-and-information 
parameter to specify an Option 45 Winchester disk drive. 
This parameter part specifies whether the disk drive will be 
used with Local Programmability and identifies bad track 
numbers. Enter /C (uppercase or lowercase) to specify disk 
drive use with Local Programmability. Express bad track 
numbers as In, where n is an integer between 1 and 65535. 
You can enter up to five bad track numbers if you do not 
specify Local Programmability; if you do specify Local 
Programmability, the limit is four. Obtain the list of bad 
tracks from the disk drive manufacturer. To identify the disk 
drive as an Option 45 drive that supports Local Programma- 
bility and has bad track numbers 25, 145, 1 299, and 5487, 
you must enter: 

W2:/C/25/1 45/1 299/5487 

If the disk you are trying to format is protected with a write- 
nrQt@(;t notch, or the disk drive in which it is mounted is 
protected with the terminal's write-protect switch, an error 
occurs and the disk is not formatted. 

All files on a disk that is not protected with a write-protect 
notch or switch are cleared, even if they have been 
protected with the PROTECT-FILE command. 

During the formatting, the terminal writes to the disk and 
immediately reads what it has written. This detects any 
"bad blocks" (defective parts of the disk surface). If any 
such bad blocks are found, then the bad blocks are not 
recorded, and execution of the format command is 
terminated. In that case, the disk is left unformatted, and a 
type JF1 3 error occurs. 



DEFAULTS 

disk-drive 

as shipped — none 
on power-up — none 
if omitted — error JF1 1 



ERRORS 

JFOO (Level 2): Unrecognized command. (Disk drive 
option not installed.) 



JF10 (Level 2) 
JF11 (Level 2) 
JF12 (Levei3) 



Device is not installed. 

Invalid device specifier. 

Out of memory while parsing the 
parameter. 

Or IO iLOVCI LI. i I IO UCVl^C O^-SO^s I iiV^t-4 iomwiu *-»»*^iv sj> > V^, iO 

write-protected, is busy, detects a verify 
error, detects a bit map error, or is not 
mounted. 

JF19 (Level 2): Hardware error at the specified disk drive. 
(Format error, drive not ready, or write- 
protect switch or notch error.) 

REFERENCES 

PROTECT-FILE command 
DIRECTORY command 
DISMOUNT command 



41 10 SERIES COMMAND REFERENCE 



7-107 



TEK COMMANDS 



GIN-Locator-Report Syntactic Construct 



NOTE 
Before reading this, see the description o/GIN-report-sequence. 



SYNTAX 



gin-locator-report = 



char-report: key 
xy-report: cursor-position 



PARTS OF THE REPORT 

key. 

The ASCII character for the key which the operator 
pressed to signal a GIN event. 

cursor-position. 

The position of the graphic cursor when the operator 
signalled a GIN event. 



DESCRIPTION 

When the terminal is enabled for a GIN (graphic input) loca- 
tor function, the graphics cursor appears and the operator 
moves the cursor (e.g., with the thumbwheels) until it is 
positioned at a location which is to be reported to the host 
computer. Then the operator signals a "GIN locator event" 
(e.g., by pressing a keyboard key). The terminal responds 
by sending a GIN-locator-report to the host. 

The GIN-locator-report is part of a larger sequence, the 
GIN-report-sequence, which includes all the GIN reports 
called for by a single ENABLE-GIN command. 

Each GIN-locator-report is preceded by a signature 
character; for details, see the descriptions of the GIN- 
report-sequence and the SET-REPORT-SIG-CHARS 
command. 



Char-Report. The char-report parameter is a single ASCII 
character: the character for the key which was pressed to 
signal the "GIN event." If the thumbwheels were chosen as 
the GIN device in the preceding ENABLE-GIN command, 
then this may be any ASCII character, since any ASCII 
character can be typed on the keyboard. 

If the GIN device is the tablet, then this character is if the 
tablet pen is used; it is Z if the one-button tablet cursor is 
used; and it is Z, 1 , 2, or 3 if the four-button cursor is used. 

If the GIN device is an accessory plotter, then this character 
is always 0, 1 , or 2: on a TEKTRONIX 4662 Plotter, if the 
pen is up, 1 if the pen is down, and 2 if the CALL button is 
held down until the bell rings; on a TEKTRONIX 4663 Plot- 
ter, if the MOVE button is pressed, 1 if the DRAW button is 
pressed, and 2 if the LAST POINT button is pressed. 



XY-Report. The xy-report parameter specifies the graphic 
cursor position (in terminal space coordinates) at the time 
that the operator signals the "locator event." Its syntax is 
similar, but not identical, to the xy syntax used for sending 
terminal space coordinates to the terminal. For more 
information, see the xy-report syntax description. 

REFERENCES 

Char-report parameter type 
ENABLE-GIN command 
GIN-report-sequence message type 
XY-report parameter type 
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GIN-Pick-Report Syntactic Construct 



NOTE 

Before reading this, see the description of the GIN-report-sequence. 



SYNTAX 



GIN-pick-report 



char-report: key 
xy-report: cursor-location 
int-report: segment-number 
int-report: pick-ID-number 



PARTS OF THE REPORT 

key. 

The ASCII character for the key which the operator 
pressed to signal the pick event. 

cursor-location. 

The position of the graphic cursor at the moment of the 
pick event. 

segment-number. 

The segment number for the segment which the operator 
picked. 

pick-ID-number. 

The pick identification number for the part of the 
segment which the operator picked. 



DESCRIPTION 

When the terminal is enabled for a GIN (graphic input) pick 
function, the graphics cursor appears and the operator 
moves the cursor (e.g., with the thumbwheels) until it is 
positioned at a segment which the operator wishes to 
"pick." The operator then signals a "pick event" (e.g., by 
pressing a key). The terminal responds by sending a GIN- 
pick-repori to the host computer. This GIN-pick-report is 
part of a larger sequence, the GIN-report-sequence, which 
includes all the GIN reports called for by a single ENABLE- 
GIN command. 

When the operator signals a pick event, the terminal returns 
a GIN-pick-report to the host computer. This occurs 
regardless of whether there actually is a visible, detectable 
segment within the current pick aperture. (If there is no such 
segment to be picked, the terminal returns zero as the 
segment number in the report.) 

If more than one visible, detectable segment falls within the 
pick aperture, the segment picked will be the one with the 
highest display priority. 

For more details, see the descriptions of the SET-PICK-ID, 
SET-SEGMENT-VISIBILITY, SET-SEGMENT- 
DETECTABILITY, SET-SURFACE-VISIBILITY, SET-PICK- 
APERTURE, and SET-SEGMENT-DISPLAY-PRIORITY 
commands. 

Each GIN-pick-report is preceded by a "signature charac- 
ter;" for details, see the descriptions of the GIN-REPORT- 
SEQUENCE and the SET-REPORT-SIG-CHARS command. 
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Char-Report. The char-report parameter is a single ASCII 
character: the character for the key which was pressed to 
signal the "GIN event." If the thumbwheels were chosen as 
the GIN device in the preceding ENABLE-GIN command, 
then this may be any ASCII character, since any ASCII 
character can be typed on the keyboard. 

If the GIN device is the tablet, then this character is if the 
tablet pen is used; it is Z if the one-button tablet cursor is 
used; and it is Z, 1 , 2, or 3 if the four-button tablet cursor is 
used. 

If the GIN device is an accessory plotter, then this character 
is always 0, 1 , or 2: on a TEKTRONIX 4662 Plotter, if the 
pen is up, 1 if the pen is down, and 2 if the CALL button is 
held down until the bell rings; on a TEKTRONIX 4663 Plot- 
ter, if the MOVE button is pressed, 1 if the DRAW button is 
pressed, and 2 if the LAST POINT button is pressed. 



Xy-Report. The xy-report parameter specifies the graphic 
cursor position (in terminal space coordinates) at the time 
that the operator signals the "pick event." Its syntax is 
similar, but not identical, to the xy syntax used for sending 
terminal space coordinates to the terminal. For more 
information, see the xy-report syntax description. 



Int-Reports. The first int-report parameter gives the seg- 
ment number of the segment being "picked." If no visible, 
detectable segment with a non-zero pick-ID falls within the 
current pick aperture, this int-report parameter is 0. 

The second int-report gives the "pick identification num- 
ber" of a part of the segment within the pick aperture. If no 
visible, detectable segment with a non-zero pick-ID falls 
within the pick aperture, then the pick-ID number in the 
GIN-pick-report is 0. 

REFERENCES 

Char-report parameter type 
ENABLE-GIN command 
GIN-report-sequence message type 
Int-report parameter type 
SET-PICK-ID command 
SET-PICK-APERTURE command 
SET-REPORT-SIG-CHARS command 
XY-report 
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GIN-Report-Sequence Message Type 



SYNTAX 



If only a single GIN device has been enabled, then the GIN-report-sequence sent to the host for that graphic input 
device has the following syntax: 

GIN-report-sequence = [GIN-report-item...] 

final-GIN-report-item 



GIN-report-item 



GIN-report = 



[EOM-indicator] 
[sig-char] 
GIN-report 
[EOM-indicator] 

( GIN-locator-report \ 
{ GIN-pick-report \ 
\GIN-stroke-report ) 



final-GIN-report-item = [term-sig-char] 

EOM-indicator 



SYNTAX GRAPHS 

The syntax just described is a little tricky; to make it easier 
to understand, it is repeated in Figure 7-5 as a series of 
"syntax graphs." 



DESCRIPTION 

A GIN-report-sequence is a sequence of reports which the 
terminal sends the host computer when enabled (by an 
ENABLE-GIN command) for graphic input from a single GIN 
device. 

If more than one GIN device has been enabled, then the 
corresponding GIN-report-sequences may be interleaved. 
That is, the GIN -report-items &x\& final-GIN -report-items 
from the various enabled GIN devices may be intermixed. 
(In that case, "signature characters" are used to distinguish 
the GIN-report-items for one GIN device from the GIN- 
report-items for another GIN device.) 

When the terminal sends a report to the host, bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 



GIN-Report-ltems. The terminal sends a GIN-report-item 
each time a "GIN event" occurs. 

If the GIN device was enabled for the "locator" or "pick" 
functions, then a GIN event occurs when the operator 
presses a keyboard key (for the "thubwheels" GIN device), 
presses the tablet pen or a button on the tablet cursor (for 
the "tablet" GIN device), or presses the appropriate button 
on the plotter (for the "plotter" GIN device). 

If the GIN device was enabled for the "stroke" function, 
then a GIN event occurs each time a new coordinate is to be 
sent to the host computer. With the "stroke" function, this 
can happen many times a second. 

A typical GIN-report-item consists of a signature character, 
followed by a GIN-report. The GIN-report format depends 
on which GIN function was enabled; it is either GIN-locator- 
report, GIN-pick-report, or GIN-stroke-report. In addition, 
an EOM-indicator (typically just the c r character) may be 
inserted at the start or end of the GIN-report-item. 



Overall syntax. The GIN-report-sequence from a single GIN 
device consists of a series of GIN-report-items, terminated 
by a final-GIN-report-item. 
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< Gl N — report — sequence > 



GIN— report— item 



D~~ 



final— GIN— report— item 



<GIN-report-item> 



EOM— indicator 



sig— char 



GIN— report 



See Note 



1.1 



See Note 2 



<GIN— report> 




GIN— locator— report 



GIN— pick— report 



GIN— stroke— report 



<GIN— locator— report > 



ASCII— character 



xy— report 



character for the key 
which was pressed 



I 



cursor location 



i 



<GIN-pick-report> 



ASCII-char 



xy— report 



int— report 



key pressed ' cursor position • 

<GIN— stroke— report > 



segment number 



1 



ASCII-char 



xy— report 



key— pressed • cursor— location 



< final— GIN— report— item> 



term— sig— char 



EOM— indicator 



EOM— indicator 



See Notes 



1 




int— report 



pick— ID number 



1 



Figure 7-5. Syntax for a Single GIN-Report-Sequence. 
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Signature Characters. The signature characters (sig-char 
and term-sig-char) are included for convenience when pars- 
ing the GIN-report-sequence. If two or more GIN devices are 
enabled at the same time, the signature characters serve to 
distinguish the GIN-report-items (an6final-GIN-report- 
items) coming from one GIN device from those coming from 
the other GIN device. 

Also, it is possible, even while GIN is enabled, to issue 
commands which cause the terminal to send a report to the 
host computer which is not part of the GIN-report-sequence. 
For instance, even while GIN is enabled, a REPORT- 
TERMINAL-SETTINGS command can cause the terminal to 
send a terminal-settings-report to the host computer. In that 
case, signature characters may be used to distinguish the 
terminal-settings-report from the GIN-report-items in the 
GIN-report-sequence. 

The two signature characters (sig-char and term-sig-char) 
are determined by the most recent SET-REPORT-SIG- 
CHARS command for the particular GIN device-function 
code. For details, see the description of the SET-REPORT- 
SIG-CHARS command. 



GIN-Reports. The GIN-reports for a single GIN device are 
all either GIN-locator-reports, GIN-pick-reports, or GIN- 
stroke-reports. The syntaxes of these are listed here as part 
of the syntax for the GIN-report-sequence. For more details, 
however, you should refer to the separate descriptions of 
the GIN-locator-report, GIN-pick-report, and GIN-stroke- 
report. 



EOM-indicators Within GIN-Report-iterns. i ne syi 
GIN-report-item includes an optional EOM-indicator at the 
start of that item, and another optional EOM-indicator at 
the end of the item. 

The EOM-indicator syntax is described elsewhere in this 
section. If the terminal is not in block mode, then the EOM- 
indicator typically is just the c r character. (If the terminal is 
not in block mode, the EOM-indicator is just the current 
EOL-string, as set by the most recent SET-EOL-STRING 
command. A typical EOL-string would consist of 
one character, c r.) 

By issuing a SET-REPORT-EOM-FREQUENCY : 1 com- 
mand, you can cause an EOM-indicator to be sent at the 
end of each GIN-report-item. That way, each GIN-report- 
item is sent to the host as a single "line" of text (if not in 
block mode), or a single block (if the terminal is in block 
mode). This may be convenient for writing host routines to 
parse the GIN-report-sequence. 



However, you can also have the terminal fit several GIN- 
report-items in the same line of text (or in the same block, if 
using block mode). To do this, choose the "less frequent" 
option in the SET-REPORT-EOM-FREQUENCY command. 
That is, issue a SET-REPORT-EOM-FREQUENCY : com- 
mand. Also, choose a maximum line length (with the SET- 
REPORT-MAX-LINE-LENGTH command) which is sufficient 
to hold two or more GIN-report-items. 

Under these circumstances, the optional EOM-indicator at 
the start of each GIN-report-item becomes important. If 
enough GIN-report-items have been sent on the current 
line, so that even one more GIN-report-item would cause 
the maximum line length to be exceeded, then the terminal 
sends an EOM-indicator at the start of the next GIN-report- 
item. That EOM-indicator serves to terminate the current 
line, so that the maximum line length is not exceeded. The 
sig-char that follows would then be the first character of the 
next line. 



Final-GIN-Report-ltem. The terminal sends afinal-GIN- 
report-item to the host computer when the graphic input 
function is disabled. This occurs when the ENABLE-GIN 
command's "count" is exhausted, when the terminal 
receives a DISABLE-GIN command, or when the operator 
presses the CANCEL key. The final-GIN-report-item con- 
sists of a term-sig-char, followed by an EOM-indicator. 



Term-Sig-Char. The term-sig-char is a single ASCII charac- 
ter, which serves to notify the host that the GIN-report- 
sequence is ended. The term-sig-char, like the sig-char 
described earlier, is set by the SET-REPORT-SIG-CHARS 

Ul/I llll ICII IU. 



Eom-lndicator in the Final-GIN-Report-Sequence. After 
the term-sig-char X\\e terminal always sends an EOM-indi- 
cator. If the terminal is not in block mode, this is the current 
EOL-string; typically it is c r. If the terminal is in block mode, 
the EOM-indicator is sent by terminating the block and 
setting the block's end-of-message bit. 

REFERENCES 

EOM-indicator syntactic construct 
ENABLE-GIN command 
GIN-locator-report syntactic construct 
GIN-pick-report syntactic construct 
GIN-stroke-report syntactic construct 
SET-REPORT-EOM-FREQUENCY command 
SET-REPORT-MAX-LINE-LENGTH command 
SET-REPORT-SIG-CHARS command 
SET-EOL-STRING command 
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GIN-Stroke-Report Syntactic Construct 



CAUTION 

Before reading this, see the description of the GIN-report-sequence. 



SYNTAX 



GIN-stroke-report = 


= char-report: key 

xy-report: cursor-location 


where 




char-report: key 


or Z or 1 or 2 or 3 

for the first point in a stroke 


char-report: key = 


= J or s b 

for subsequent points in a stroke 


char-report: key = 


= Oor u s 

for the last point in a stroke 



PARTS OF THE REPORT 

key. 

For the first point in a stroke, the "key" character is if 
the operator uses a stylus, and Z, 1 , 2, or 3 if a tablet 
cursor is used instead. Normally, subsequent points in a 
stroke are indicated with the letter J, and the last point 
with the letter O. However, these may be changed to the 
control characters s s and u s, respectively, by the SET- 
TABLET-HEADER-CHARS command. 

cursor-location. 

The location of the graphic cursor for one point of the 
stroke. 



DESCRIPTION 

When an ENABLE-GIN command has enabled the graphic 
tablet for the "stroke" function, the GIN-reports sent to the 
host in the GIN-report-sequence are GIN-stroke-reports. (In 
the GIN-report-sequence, each GIN-stroke-report is pre- 
ceded by a signature character; see the description of the 
GIN-report-sequence for details.) 



For each "stroke" that the operator performs at the tablet, 
many GIN-stroke-reports axe sent to the host computer. 



First Point in the Stroke. The stroke begins when the oper- 
ator presses the tablet pen against the tablet. If a one-but- 
ton or four-button cursor is used instead of a pen, the stroke 
begins when the operator places the cursor on the tablet 
surface and presses a button on the cursor. The terminal 
then sends the first GIN-stroke-report to the host computer. 

If the operator uses the tablet pen, then the key in the GIN- 
stroke-report is the ASCII character 0. If the operator uses 
the optional one-button cursor, then the key is Z. If the oper- 
ator uses the optional four-button cursor, then the key is Z, 
1 , 2, or 3, depending on which cursor button is pressed. 



Subsequent Points. As the operator moves the stylus or 
cursor across the tablet, subsequent GIN-stroke-reports 
are sent. These report the positions through which the tab- 
let pen or cursor moves. 
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For each of these reports, the key field is either the ASCII 
character J or the ASCII control character, s b. The default is 
the letter J; however, this can be changed to s b with the 
SET-TABLET-HEADER-CHARACTERS command. 



Last Point. The stroke ends (a) when the ENABLE-GIN 
command's count expires, or (b) when the operator stops 
pressing the pen against the tablet, removes the cursor 
from the tablet surface, or releases the button on the cursor. 
The stroke also ends if the terminal's output buffer is filled 
up; more about that later. 

If the stroke ends by the ENABLE-GIN command's count 
expiring, then the last point in the stroke is a valid data point 
like the ones that preceded it. In that case, the GIN-stroke- 
report for the last point uses the same key as for the preced- 
ing points: the letter J or the control character s b, as the 
case may be. 

If the stroke ends by an operator action (such as removing 
the pen from presence), it is possible that the last xy-report 
does not represent a valid coordinate. In that case, the final 
GIN-stroke-report includes a key field which is either the 
ASCII letter O or the ASCII control character, u s. The default 
is the letter O; however, this can be changed to u s with the 
SET-TABLET-HEADER-CHARACTERS command. 

This different char-report — O or u s — serves to notify the 
host program that it should not rely on the accuracy of the 
associated xy-report. 



Filling Up the Output Buffer. It is easy, when using the 
stroke graphic input function, to digitize points faster than 
the terminal can send the corresponding GIN-stroke- 
reports to the host computer. When this happens, the termi- 
nal's output buffer can overflow. (You may be able to avoid 
this condition by using a high baud rate, or by using stroke 
filtering in order to digitize points less frequently.) 

If the terminal's output buffer is full, then the terminal can 
accept no more graphic input data until some of the charac- 
ters in that buffer have been sent to the host computer. With 
the buffer full, attempting to enter more points (a) causes 
the current stroke to end, and (b) causes the terminal to 
sound its bell. The bell serves to warn the operator to pause 
before digitizing more points. (The pause gives time for the 
terminal to transmit characters to the host, thereby freeing 
memory in the output buffer.) 



REFERENCES 

Char-report parameter type 
ENABLE-GIN command 
SET-BAUD-RATES command 
GIN-report-sequence message type 
SET-GIN-STROKE-FILTERING command 
SET-TABLET-HEADER-CHARACTERS command 
XY-report parameter type 
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GRAPHIC-TEXT Command 



Host Syntax 



E cLT str\ng:text-to-be-displayed 



Setup Syntax 



E cLT s p text-to-be-displayed 



PARAMETERS 



text-to-be-displayed. 



A string containing ASCII characters in the range from s p 
to " — decimal equivalents in the range from 32 to 1 26. 



DESCRIPTION 

The specified text string is drawn, starting at the current 
beam position. (More precisely, the lower left corner of the 
first graphtext character's character cell is positioned at the 
current beam position.) The beam position is updated to the 
lower left corner of the character envelope of the next char- 
acter position past the last character written. 

The string is drawn in the current graphtext font, as deter- 
mined by the most recent SET-GRAPHTEXT-FONT com- 
mand. If no graphtext font has been selected, then font zero 
is used. 

Table 7-15 lists the predefined graphext fonts. On a 41 12, 
41 1 3, 4114, and 41 1 6, if Option 4A, 4C, 4E, or 4F is 
installed, fonts 0, 1 , 3, 7, and 9 are available. On a 41 15, if 
Option 4A, 4C, or 4F is installed, fonts 0, 1 , 3, and 9 are 
available. On all terminals, if Option 4K is installed fonts 0, 
10, and 1 1 are available. If no keyboard option is installed, 
then only font is predefined. 

Any characters in the current font which have not been 
user-defined are displayed as the corresponding character 
in the predefined font with the same font number. If there is 
no predefined font with the same font number, then the 
corresponding character of font is used. 



Table 7-15 

GRAPHTEXT FONTS AVAILABLE 
WITH KEYBOARD OPTIONS 



Font Number 


Graphtext Font 





Standard ASCII 


1 


Swedish 


3 


United Kingdom 


7 


APL (not available 
on the 41 15) 


9 


Danish/Norwegian 


10 


JIS Roman 


11 


JIS Katakana 



If "stroke precision" is used (the default in the absence of a 
SET-GRAPHTEXT-PRECISION command), then the 
graphtext is drawn as a series of vectors. Its appearance is 
governed by the most recent SET-TEXT-INDEX, SET- 
GRAPHTEXT-SIZE, SET-GRAPHTEXT-FONT, SET- 
GRAPHTEXT-SLANT, and SET-GRAPHTEXT-ROTATION 
commands. 

If the most recent SET-GRAPHTEXT-PRECISION command 
specified "string precision," then the graphtext is displayed 
as if it were alphatext, except that it does not wrap at the 
right edge of the display. In that case, the SET- 
GRAPHTEXT-FONT, SET-GRAPHTEXT-SLANT, SET- 
GRAPHTEXT-SIZE, and SET-GRAPHTEXT-ROTATION 
commands have no effect. Instead, the graphtext appear- 
ance is governed by the most recent SET-TEXT-INDEX, 
SET-ALPHATEXT-SIZE, SET-4014-ALPHATEXT-SIZE, and 
SET-ALPHATEXT-FONT commands. 
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if the final beam position would end up outside terminal 
space as the result of displaying a graphtext chracter, that 
character is not displayed (not even partially). Any part of a 
graphtext character being displayed that extends outside 
terminal space is clipped. 

Graphtext is not allowed within a panel definition. That is, 
the GRAPHIC-TEXT command is not allowed between a 
BEGIN-PANEL-BOUNDARY command and the following 
END-PANEL command. If you do issue a GRAPHIC-TEXT 
command within a panel-definition, the terminal detects a 
type LT03 error. 



ERRORS 

LT03 (Level 2): Command is invalid at this time. 

(Graphtext is not allowed within a panel- 
definition. 

LT11 (Level 2): Invalid array count (must be in range from 
to 65535). 

LT12 (Level 3): Out of memory while parsing the 
parameter. 



REFERENCES 



DEFAULTS 

text-to-be-displayed 
as shipped — none 
on power-up — none 
if omitted — empty string 



END-GRAPHTEXT-CHARACTER command 
SET-ALPHATEXT-FONT command 
SET-ALPHATEXT-SIZE command 
SET-GRAPHTEXT-FONT command 

SCT OD A OUTCVT DDCnOinM s-w^mmrtm."! 
t- j-Ctrirvr i i t t-/\ i-r i~il_v^ivjiwim wuiiinidiiu 

SET-GRAPHTEXT-ROTATION command 
SET-GRAPHTEXT-SIZE command 
SET-GRAPHTEXT-SLANT command 
SET-TEXT-INDEX command 
SET-4014-ALPHATEXT-FONT command 
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HARDCOPY Command 



Host Syntax 



E cKH int: hard-copy-code 



Setup Syntax 



E cKH s p hard-copy-code 



PARAMETERS 

hard-copy-code (0, 1 , or 2). 

Selects the type of hardcopy operation that is generated 
with respect to the type generated by the HARD COPY 
key. 

Same as the HARD COPY key for all 
terminals. 

1 Same as the HARD COPY key for the 41 1 2, 
41 1 3, and 41 1 5. Same as the Shifted HARD 
COPY key for the 41 1 4 and 41 1 6. 

2 Same as the HARD COPY key for the 41 1 4 
and 41 16. Same as the Shifted HARD COPY 
key for the 41 1 2 and for the 41 1 3 and 41 1 5 if 
Option 09 is not installed, or if Option 09 is 
installed and the standard hardcopy inter- 
face is selected. If Option 09 is installed on a 
41 1 3 or 41 1 5, and the color hardcopy inter- 
face is selected, this code causes a black/ 
white inversion. 



If you are using a 41 1 3 or 41 1 5 with Option 09 (the color 
hard copy interface) installed, this command generates a 
hardcopy on the unit attached to the interface selected by 
the SELECT-HARDCOPY-INTERFACE command. The color 
hard copy interface requires that a TEKTRONIX 4691 Color 
Graphics Copier be attached for proper operation. 

During a hard copy, operation of the display is suspended. 
Other activity is allowed, but any display activity is queued 
until the hard copy operation is finished. 



4112. On a 41 12, if the hard copy code is or 1 , the action 
is the same as the HARD COPY key on the keyboard. A 
hard copy is made in such a way that white lines on the 
display appear as black lines on the hard copy. 

If the hard copy code is 2, the action is the same as the 
SHIFT-HARDCOPY key. A hard copy is made in such a way 
that white lines (on a black background) on the display 
appear also as white lines on a black background on the 
hard copy (video inversion). (If no hard copy unit is 
attached, the HARDCOPY: 2 causes the screen to "flash.") 



DESCRIPTION 

This command generates a hardcopy if there is the proper 
type of hardcopy machine attached to the terminal's hard- 
copy interface. 41 12 terminals and 41 13 and 41 1 5 terminals 
without Option 09 installed require a TEKTRONIX 461 2 or 
4632 Video Hard Copy Unit, and 41 1 4 terminals require a 
TEKTRONIX 461 1 or 4631 Hard Copy Unit. 



41 1 3 and 41 1 5. This command is the same on the 41 1 3 and 
41 15 as on the 41 12, unless Option 09 is installed and the 
SELECT-HARDCOPY-INTERFACE command has been set 
to the color hardcopy interface. If this is the case, HARD- 
COPY: 2 causes a black/white inversion instead of a video 
inversion. 
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41 14 and 41 16. On a 41 1 4 ro 41 1 6,if the hard copy code is 
or 2, the action is the same as the HARD COPY key on the 
keyboard. A hard copy is made on that hard copy unit. 
Objects displayed in refresh mode are "fixed" (drawn once 
in storage mode) before the copy is made, so they may 
appear on the copy. 



DEFAULTS 

hard-copy-code 
as shipped — none 
on power-up — none 
if omitted — 



If the hard copy code is 1 , the action is the SHIFT-HARD- 
COPY key on the keyboard. A hard copy is made. Objects 
displayed in refresh mode are not fixed before the copy 
operation; consequently, they do not appear on the hard 
copy. 



4010-HARDCOPY Command. The 41 1 includes a 401 0- 
hardcopy Gommand for compatibility with host software 
written for earlier TEKTRONIX terminals: 



ERRORS 

KH01 (Level 2): Copier fault condition; operator assist- 
ance required (Option 9 only). 

KH 1 1 (Level 2): Invalid hard-copy-code (must be 0, 1 , 
or 2). 

KH 1 9 (Level 2): Color hardcopy device not ready (Option 
9 only). 



4U10-HAHUUUPY 



^C^B 



The 401 0-HARDCOPY command is equivalent to a HARD- 
COPY: command. 



REFERENCES 

401 0-HARDCOPY command 
HARDCOPY Key 
SELECT-HARDCOPY-INTERFACE command 
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HARD COPY Key 



DESCRIPTION 

Pressing the HARD COPY key initiates a hard copy opera- 
tion. This requires that a TEKTRONIX 4631 or 461 1 Hard 
Copy Unit, a TEKTRONIX 4632 or 461 2 Video Hard Copy 
Unit, or a color hardcopy unit, if you are using a 41 1 3 or 
41 15 withOption 09 installed, is attached to the appropriate 
hardcopy interface on the back of the terminal. 

During a hard copy, operation of the display is suspended. 
Other activity is allowed, but any display activity is queued 
until the hard copy operation is finished. 



41 12. On a 41 12 pressing HARD COPY causes a hardcopy 
to be made using the usual convention for hardcopies: lines 
which appear on the screen as white lines on a black back- 
ground appear on the hardcopy as black lines on a white 
background. Thus alphatext, which is normally displayed 
"white on black" appears on the hard copy paper as "black 
on white" - the customary format for displaying print on 
paper. 

Pressing SHIFT-HARD COPY causes a hardcopy to be 
made using the opposite convention: lines which appear on 
the screen as white on a black background appear also on 
the hard copy as white on a black background (video inver- 
sion). If no hard copy unit is attached, SHIFT-HARD COPY 
causes the screen to "flash." 



41 13 and 41 15. Pressing this key (both shifted and 
unshifted) causes the same operations on the 41 1 3 and 
41 1 5 as on the 41 1 2, unless Option 09 is installed and the 
SELECT-HARDCOPY-INTERFACE command has set the 
copy interface to the color hardcopy interface. If this is the 
case, a color hard copy is generated (provided the 4691 
Color Graphics Copier is attached) when the HARD COPY 
key is pressed. If the SHIFT-HARD COPY key is pressed, a 
color hardcopy is generated with black and white only 
inverted. 



41 14 and 41 16. With a 41 14 or 41 16, in oraer that oojects 
displayed in refresh mode may appear on the hard copy, all 
such objects (segments in refresh mode, and text in the 
dialog area) are "fixed" on the screen — drawn once in 
storage mode. The segment attributes are not changed, 
however: after the hard copy, you can press PAGE to erase 
the screen, and any refresh mode objects will again appear 
in refresh mode. 

Pressing SHIFT-HARD COPY copies only objects drawn in 
storage mode; objects displayed in refresh mode are not 
fixed on the screen. 

The HARD COPY and SHIFT-HARD COPY keys do not 
auto-repeat. 



REFERENCES 



HARDCOPY command 
SELECT-HARDCOPY-INTERFACE command 
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h t Character 

DESCRIPTION 



Alpha Mode. When the terminal is in Alpha mode and the 
dialog area is disabled, and it receives an ASCII h t "hori- 
zontal tab" character, the alpha cursor moves one character 
position to the right, as if a s p character had been received. 

If the dialog area is enabled, an h t causes the alpha cursor 
to move right to the next defined tab stop or the right edge of 
the dialog area if no tab stops are encountered. 



Marker and Vector Modes. When the terminal is in marker 
mode or vector mode, the h t character has no effect. 



REFERENCES 

ENTER-ALPHA-MODE command 
ENTER-VECTOR-MODE command 
ENTER-MARKER-MODE command 
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IGNORE-DELETES Command 



Host Syntax 



E cKI m\:ignore-deletes-mode 



Setup Syntax 




PARAMETERS 

ignore-deletes-mode (0 or 1). 

Specifies whether d t characters should be ignored or 
not. Setup mode parameters are YES and NO. 

NO; do not ignore d t characters. 

1 YES; ignore d t characters 

DESCRIPTION 



DEFAULTS 

ignore-deletes-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

KI11 (Level 2): Invalid ignore-deletes-mode (must be 
0or1). 



This command determines if the terminal parser will ignore 
d t (delete) characters. If the parameter is 1 , the terminal 
ignores any d t characters that it receives. If this is the case, 
the host should substitute V? for any d t characters it would 
send when sending int or xy parameters to the terminal. 

If the parameter is 0, the terminal parser does not ignore d t 
characters. 



REFERENCES 

Delete-equivalent syntactic construct 
Int parameter type 
xy parameter type 
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INCLUDE-COPY-OF-SEGMENT Command 



Host Syntax 



E cLK inV.segment-number 



Setup Syntax 



E cLK s p segment-number 



PARAMETERS 

segment-number (-3, -1 , or 1 to 32767). 
Specifies the segment to be included, 

_3 all existing segments that match the current 

matching class. 

-1 all existing segments. 

1 to 32767 the specified segment. 

DESCRIPTION 

This command causes the following to occur: 

• On a 41 12, 41 13, and 41 15, if a panel is being defined it 
is ended and filled. 

• The current primitive attributes are saved. These include 
the graphic beam position, line style, line index, text 
index, marker type, and pick ID. In the 41 1 4 and 41 1 6, 
these also include the alphatext size and line width. In 
the 41 1 2, 41 1 3, and 41 1 5, the graphics area writing 
mode and background indices, panel style and fill pat- 
tern are also included. In the 41 15, 4014 alphatext size is 
also saved. 

• The designated segment (scaled, rotated, and posi- 
tioned according to its current image transform parame- 
ters) is copied into the graphics area and any segment 
being defined. The initial default pick-ID is not copied, 
but all explicitly set pick-IDs are copied. None of the 
included segment's attributes, such as highlighting or 
detectability, are carried over into the new segment. 

• The primitive attributes that were saved are restored. 

• If no segment is open, the included segment is displayed 
in the current writing mode (i.e., that of the default 
segment). 



On the 41 1 2, 41 1 3, and 41 1 5 terminals, including a copy of 
a segment whose Writing mode is XOR into a segment 
whose default Writing mode is XOR causes the included 
segment's image to be erased. Due to integer round-off 
during multiple transforms, some pixels may not be erased 
properly. To correct this problem, move, delete, or change 
the visibility of one of the segments. 



DEFAULTS 



segment-number 
as shipped — none 
on power-up — none 
if omitted — LK1 1 



ERRORS 

LK02 (Level 3): Out of memory while performing 

INCLUDE-COPY-OF-SEGMENT (4112, 
4113, and 41 15 only). 

LK10 (Level 2): Segment does not exist. 

LK1 1 (Level 2): Invalid segment-number (must be -3, -1 , 
orfroml to 32767). 

LK1 3 (Level 2): The segment specified is currently being 
defined. 



REFERENCES 

END-PANEL command 
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Int Parameter Type 



SYNTAX 



int = 
Lol 



[Hil [Hil [Hil [Hil [Hil\\\\] Lol 



= an ASCII character whose numeric equivalent is in the range from 32 to 63 : a character whose 
most-significant bits are "01 ". 

Hil = an ASCII character whose numeric equivalent is in the range from 64 to 127. E c? may be used as a 
substitute for d t, character number 127. 



DESCRIPTION 

Integer numbers are sent to the terminal in a packed format, 
as int parameters. The packed format consists of a series of 
from one to six ASCII characters. The first zero through five 
of these characters have ADE's of 63 through 1 27. These 
are the Hirs. The final (or only, if you are sending an integer 
that packs into a single character) character can have an 
ADE of 32 through 63. This is the Lol. 

int parameters represent integers ranging from -2 31 to 
2 31 -1 . Valid range on terminals that are not 41 1 5's is 
-32767 to 65535. The exact range for int parameters 
depends on the command in which the int is used. 



Examples. The coding scheme is devised so that numbers 
from -1 5 to +15 may be sent as a single character; for 
integers from to 9, the int parameter is just the single 
ASCII character for that digit: 



int 


-0 


= 


s p 


int 





= 





int 


-1 


= 


! 


int 


1 


= 


1 


int 


-2 


= 


C( 


int 


2 


= 


2 


int 


-3 


= 


# 


int 


3 


= 


3 


int 


-4 


= 


$ 


int 


4 


= 


4 


int 


-5 


= 


o/o 


int 


5 


= 


5 


int 


-6 


= 


& 


int 


6 


= 


6 


int 


-7 


= 


' 


int 


7 


= 


7 


int 


-8 


= 


( 


int 


8 


= 


8 


int 


-9 


= 


) 


int 


9 


= 


9 


int 


-10 


= 


* 


int 


10 


= 




int 


-11 


= 


+ 


int 


11 


= 


» 


int 


-12 


= 


) 


int 


12 


= 


< 


int 


-13 


= 


- 


int 


13 


= 


= 


int 


-14 


= 




int 


14 


= 


> 


int 


-15 


= 


/ 


int 


15 


= 


? 



For numbers with absolute values greater than 1 5, the cor- 
responding int parameters consist of more than one charac- 
ter. For examples and a way to figure any int within the valid 
range, see Appendix B. 



Explanation. The int parameter consists of zero to five Hil 
characters, followed by one Lol character. The Lol charac- 
ter holds the sign bit and the least-significant four data bits 
for the "sign-magitude" binary representation of the integer. 
The ////characters need only be sent if the integer is large 
enough to require more than four data bits and a sign bit; 
these ////characters each hold six data bits. 



Lol Character. The Lol character has this format: 

1 s d d d d 

Here, s is the sign bit: 1 for positive integers, and for nega- 
tive integers. The bits "dddd" are the least-significant bits 
in the binary numeral representing the magnitude of the 
integer. 

Hil Characters. The ////characters have this format: 

1 d d d d d d 

Here, "dddddd" represent six of the more-significant bits 
in the binary numeral representing the magnitude of the 
integer. 
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Packing Procedure. To represent a number in the range 
from -2 31 to 2 31 -1 as an int parameter, do the following: 

1 . Determine the sign of the number. Remember it for 
later use. 

2. Translate the magnitude (absolute value) of the number 
into binary format. 

3. Take the four least significant (rightmost) bits. These 
now represent the least significant bits in the Lol byte. 

4. If the sign of the integer was positive, set the fifth least 
significant bit of the Lo/byte to 1 . If the sign of the 
integer was negative, set the fifth bit to 0. 

5. Add 32 to the byte (i.e. , set the sixth least significant bit 
to1). 

6. Find the ASCII character that corresponds to the byte 
you've just filled. This is the Lol character. Remember 
— it is the last character you send to the terminal. 

7. Take the six least significant bits of the remaining 
binary representation. These now represent the six 
least significant bits of a Hil byte. 

8. Add 64 to the byte (i.e., set bit seven to 1). 

9. Fi nd the ASCI I character that corresponds to th byte 
you've just filled. This is the Hil character. Send it to 
the terminal before you send the byte(s) you have previ- 
ously packed. 



1 0. Repeat steps 7. through 9. for six-bit sections (from 
right to left) of the binary representation until all the 
remaining bits are zeros. 

1 1 . Send the resulting characters to the terminal in reverse 
order from the way you packed them (last one first). 

Figure 7-6 shows an example of the packing algorithm in 
action. 



Control Characters Ignored. Within int parameters, ASCII 
control characters are ignored. 1 1 isse are ti 16 Ci iaracisrs 
with decimal equivalents in the range from to 31 . For 
instance, the terminal ignores any c r and l f characters 
which it may encounter while parsing an int parameter. 

However, the E c, u s, G s, and F s characters are exceptions. 

Thrtcfl sra +ki« ^hara^ore wrhi^h ranco n mmmanri tn hp 

I I IOOC OlG II IS> \*» IS*» WWIWI *J «*■ IISSI • ^«ww — ~~ —..— .— 

terminated early. (For details, see "Commands of Three or 
More Characters," in Section 2.) When the terminal encoun- 
ters a u s, G s, or F s character, or an E c character that begins a 
command, within an int parameter, it terminates both the int 
parameter and the command of which that parameter is a 
part. 



REFERENCES 

Array parameter types 
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Suppose you wanted to convert the number 1129 to int format. 
Perform the following steps: 

STEPS INT 

1. Determine the sign: 1129 is positive 

2. Translate to binary: 1129 (dec) = 10001101001 (bin) 

3. Take the four least significant bits: 
1000110 ,1001. J 00 1, 

4. Set the 5th bit to 1 (because 1129 is positive): 

5. Set the 6th bit to 1 : 
111001 

6. Find the corresponding ASCII character: 
11 1001 =9 

This is the Lol character. Put it aside. 9 

7. Take the six least significant bits of the 
remaining binary representation: 

1 ,000110, .000110. 

^=! ! i 

8. Set the 7th bit to 1 : 
1000110 

9. Find the corresponding ASCII character: 
10001 10 = F 

This is the first Hil character. 

Put it aside with the Lol character. F9 

10. Repeat steps 7 through 9 for remaining 

binary representation. Fill in any missing bits 
with zeros: 

1 000001 
1000001 
1000001 = A 

Put the characters aside with the others. AF9 

11. Send the resulting characters to the terminal 
in reverse order from the way you calculated 
them. 



to the terminal 



-AF9 
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Int-Report Message Type 



SYNTAX 



int-report = [EOM-indicator] 
Hil-report 
Hil-report 
Lol-report 

Hil-report = an ASCII character whose numeric equivalent is in the range from 32 to 95. 

Lol-report = an ASCII character whose numeric equivalent is in the range from 32 to 63. 



cdvnir i iv/ii 

When the terminal has occasion to send integer numbers to 
the host computer, it sends those numbers packed in the 
int-report format. (This may happen, for example, in 
response to any of a variety of "inquiry" commands : 
REPORT-TERMINAL-STATUS, REPORT-SEGMENT-STA- 
TUS, REPORT-ERROR-STATUS, etc.; or as part of a GIN- 
pick-report in response to an ENABLE-GIN command.) 

The host computer sends integers to the terminal using the 
int syntax. The terminal sends integers to the host using the 
int-report syntax. These two formats are similar, but not 
identical: 

• The int-report may include an EOM-indicator to termi- 
nate a "line" of data being sent to the host. (The EOM- 
indicator will be sent if not sending it would cause the 
current maximum line length to be exceeded.) When 
parsing an int-report, provision must be made for coping 
with this EOM-indicator. 

• Unlike int parameters, int-reports always have three 
characters. 

• The packing scheme for an int-report's Lol-report char- 
acter is identical to that for an int's Lol character. 

• The packing scheme for an int-report's Hil-report char- 
acters uses a different "offset" than for an int's ////char- 
acters. In an int's ////character, 64 is added to a six-bit 
binary numeral to form the ASCII decimal equivalent of 
the ////character. In an int-report's Hil-report character, 
32 (rather than 64) is added to the six-bit binary numeral. 

EOM-indicator. The EOM-indicator is rarely included in the 
int-report. The terminal only sends this EOM-indicator if 
there is no other way to avoid exceeding the current maxi- 
mum line length. See the EOM-indicator description for 
details. 



The optional EOM-indicator, if sent in the int-report, will 
always be the terminal's current EOL-string. This EOM- 
indicator is rarely sent. The reason for this is that an int- 
report is always part of some larger report message, and 
the syntax of that larger report generally makes provision 
(with its own EOM-indicators) for terminating lines before 
the maximum line length is exceeded. 

However, if the maximum report line length is set too short, 
then it is possible that optional EOM-indicators in the syn- 
tax of the larger report would not cause the line to terminate 
soon enough. Only in that case would the optional EOM- 
indicator in the int-report syntax come into play. 



Parsing an Int-Report. A general-purpose routine for pars- 
ing int-reports should take into account the optional EOM- 
indicator. 

Since this EOM-indicator will only be sent if the terminal is 
not in block mode, and in that case the EOM-indicator is 
just the current EOL-string, the parsing routine should be 
able to distinguish the current EOL-string from valid Hil- 
report and Lol-report characters. 

This is easiest to do if the EOL-string consists only of control 
characters, such as c r and l f. In that case, the parsing rou- 
tine can just skip over any such control characters. 



REFERENCES 

EOM-indicator syntactic construct 
Int parameter type 
Intc-report message type 
SET-COORDINATE-MODE command 
SET-MAX-REPORT-LINE-LENGTH command 
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Intc-Report Message Type 



4115 



SYNTAX 



intc-report = [EOM-indicator] 

[Hil-report [Hil-report [HH-report 
[Hil-report [Hil-report]]]]] Lol-report 

Hil-report = an ASCII character whose numeric equivalent is in the range from 32 to 95. 

Lol-report = an ASCII character whose numeric equivalent is in the range from 32 to 63. 



DESCRIPTION 

Intc-reports are equivalent to int-reports, except that they 
have a greater range. 

On a 41 1 5 terminal, intc-reports are the size specified by 
the int-report-size parameter of the SET-COORDINATE- 
MODE command. Only the 32-bit coordinate xy-report intc- 
reports that are sent when the terminal is in Coordinate 
mode 1 are longer than three bytes long. Other 4115 intc- 
reports have the same syntax as the int-reports of the other 
terminals. 

The EOM-indicator in an intc-report has the same function 
as the EOM-indicator in an int-report. 



REFERENCES 

EOM-indicator syntactic construct 
Int parameter type 
Int-report message type 
SET-COORDINATE-MODE command 
SET-MAX-REPORT-LINE-LENGTH command 
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Int-Array-Report Message Type 

See Array-report parameter types. 



l f Character 



DESCRIPTION 



Key-Execute-Character 

The key-execute-character is a single ASCII character, deter- 
mined by the SET-KEY-EXECUTE-CHARACTER command. 
When a macro numbered from to 143 is invoked by press- 
ing the corresponding key, the key-execute-character delim- 
its those characters which are to be executed locally by the 
terminal, and not sent to the host computer. The key-exe- 
cute-character serves only as a delimiter; it is neither exe- 
cuted locally nor sent to the host computer. 

The key-execute-character oniy has its speciai effeci when a 
macro is invoked by pressing a key. If a macro is invoked 
with the EXPAND-MACRO command, any key-execute- 
characters within it are treated just like other characters in 
the macro definition. 



REFERENCES 

DEFINE-MACRO command 
EXPAND-MACRO command 
SET-KEY-EXECUTE-CHARACTER command 



Vector and Marker Modes. The l f character has no effect 
when the terminal is in Vector mode or Marker mode. 



Alpha Mode, Dialog Area Disabled. ^ moves the alpha 
cursor and beam position down one line. If moving the alpha 
cursor down one line would place its lower left corner off the 
screen, then: 

• If a segment is currently being defined, then no vertical 
movement occurs. 

• If no segment is being defined, the alpha cursor and 
beam position move to ihe top of the screen (y = 3071), 
at the next margin. If the current margin is the last mar- 
gin (the Nth margin if N margins are defined), then a 
page-full condition occurs. 41 1 2, 41 1 3, and 4115 termi- 
nals have only one margin. 41 14 and 4116 terminals can 
have up to eight margins. What happens next depends 
on the most recent SET-PAGE-FULL-ACTION command. 

• If LFCR mode is enabled ( l f implies c r), the alpha cursor 
and beam position are moved to the current left margin. 



Alpha Mode, Dialog Area Enabled. If the dialog area is 
enabled, then h= moves the cursor down one line in the 
dialog area without affecting the column position. If the 
original cursor position was on the bottom visible line, the 
dialog area scrolls. 

If the LFCR mode is enabled, the cursor also moves to the 
beginning of the line. 

If the cursor was originally located on the bottm line of the 
scroll buffer (reguardless of whether it was visible or not), 
receipt of a l f character deletes the top scroll buffer line, 
renumbers the original lines (subtracting 1 from each line 
number), and inserts an empty line at the bottom of the 
scroll buffer. 



REFERENCES 

LFCR command 
SET-MARGINS command 
SET-PAGE-FULL-ACTION command 
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LFCR Command 



Host Syntax 



E cKF M:LFCR-mode 



Setup Syntax 




PARAMETERS 

LFCR-mode (0 or 1). 

Specifies whether line feed actions imply carriage return 
actions. Setup mode parameters are YES an NO. 

NO; l f characters are treated as l f charac- 
ters only. 

1 YES; l f characters are treated as l f c r 
sequences. 

DESCRIPTION 

If the parameter is 1 , LFCR mode is enabled. When LFCR 
mode is enabled, each l f character received when the ter- 
minal is in Alpha mode is processed as a line feed followed 
by a carriage return. 

If the LINE-FEED key on the terminal keyboard is pressed, 
no carriage return is sent to the host, reguardless of LFCR 
mode. 

If the parameter is 0, LFCR mode is disabled. 



DEFAULTS 

LFCR-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

KF11 (Level 2): Invalid LFCR-mode (must be or 1) 

REFERENCES 

CRLF command 
l f character 
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Host Syntax 



E cJL dev\ce:source 



Setup Syntax 



LOAD s p source 



3ADAMCTCDC 
'niiniiii. ■ ^riw 



DEFAULTS 



source 

The device or file to be executed as a command file. 
Valid specifiers are: 

HO: the host communications port 

FO: filename files on Disk Drive FO: 

filename 

F1 : filename files on Disk Drive F1 : 

SO:filename — files on the Option 45 disk drives 
Z7:filename 

DM: the DMA interface 

DESCRIPTION 

This command causes the source to be source for com- 
mands, as if the host had transmitted the file contents to the 
terminal. 

The commands being loaded may contain other LOAD 
commands. LOAD commands can be nested five deep; 
deeper nesting causes error JL03. 

Keyboard data entered during a load operation is are 
queued until execution is completed. An load operation can 
be aborted by pressing the CANCEL key. 

Report commands cause reports to be sent to the host, 
requardless of the source of the load operation . 



source 

as shipped — none 
on power-up — none 
if omitted — error J L1 1 



ERRORS 

JL02 (Level 3): 

JL03 (Level 2): 
JL10 (Level 2): 



Out of memory while performing LOAD 
command. 

Nesting error. (LOAD commands are 
nested too deeply.) 

File or device does not exist. 



JL12 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

JL13 (Level 2): Context error in parameter 1. (Not a valid 
source device, device is busy, or com- 
mand detects a disk format error.) 

JL19 (Level 2): Device hardware error (disk hardware 

error, drive not ready, or DMA block trans- 
fer error). 



REFERENCES 

CANCEL key 

EXPAND-MACRO command 
SAVE command 
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LOCAL Key 



DESCRIPTION 



REFERENCES 



Pressing the LOCAL key once causes the terminal to enter 
Local mode and turns on the light in the key. Pressing the 
key again turns off the light and removes the terminal from 
Local mode. 

When the terminal is in Local mode (that is, when the light in 
the LOCAL key is on), the terminal does not respond to 
characters coming from the host. Instead, it stores these 
characters in the "communications queue" part of its mem- 
ory. When the queue is full, the oldest characters are dis- 
carded to make room for the new ones. You can change the 
size of the communications queue with the SET-QUEUE- 
SIZE command. 



COPY command 
DIRECTORY command 
PORT-COPY command 
SAVE command 

SET-KEY-EXECUTE-CHARACTER command 
SET-QUEUE-SIZE command 
SETUP key 
SPOOL command 



Also, while the terminal is in Local mode, characters typed 
on the keyboard are not sent to the host computer. Instead, 
they are sent to the terminal's command processor, as if 
they had come from the host. 

If you attempt to transfer files to the host (HO:) with a COPY, 
SAVE, SPOOL, PORT-COPY, or DIRECTORY command, 
the data goes to the terminal's alpha-exchange and are 
printed on the terminal screen. 

If both the SETUP and LOCAL lights are on, the terminal is 
in Setup mode and Local mode. Messages to the host are 
echoed to the display, including reports and file transfers. 
Key-execute-characters are displayed when the terminal is in 
both modes simultaneously. 

The LOCAL key does not auto-repeat. 
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LOCK-KEYBOARD Command 

Host Syntax 



E cKL mV.locking-mode 



Setup Syntax 



LOCKKEYBOARD s p 



PARAMETERS DEFAULTS 

locking-mode (0 or 1 ). locking-mode 

Specifies whether the keyboard is locked or unlocked. as shipped — 

Setup mode parameters are YES and NO. on power-up — 

NO; unlocks the keyboard. ,T ominea _ ° 

1 YES; locks the keyboard. 

ERRORS 

DESCRIPTION KL11 (Level 2): Invalid locking-mode (must be or 1). 

The LOCK-KEYBOARD command lets the host computer 

disable the keyboard keys. (This is useful at times when a REFERENCES 

host computer program cannot tolerate input from the 

operator.) CANCEL key 

\y#-u>ivswi- \*\j\ i ii i iCli iu 

To lock the keyboard, send the following command: LOCK-VIEWING-KEYS command 

lock-keyboard : 1 
= E cKLint: 1 
= E cKL1 

When the keyboard is locked, the KYBD LOCK light is on, 
and all keys in the basic keyset, except the CANCEL and 
BREAK keys, are inoperative. 

The keyboard can be unlocked by issuing a KEYBOARD- 
LOCK command in which the parameter is 0. It can also be 
unlocked by pressing the CANCEL or BREAK key, or issu- 
ing a CANCEL command. 
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LOCK-VIEWING-KEYS Command 



4112,4113,4115 



Host Syntax 



E cRJ int: locking-mode 



Setup Syntax 



| E cRJ s p locking-mode 



PARAMETERS 

locking-mode (0 or 1). 

Specifies whether the viewing keys are locked or 
unlocked. Setup mode parameters are YES and NO. 

NO; unlocks the viewing keys. 

1 YES; locks the viewing keys. 

DESCRIPTION 

The LOCK-VIEWING-KEYS command lets the host pro- 
gram disable the terminal's four viewing keys. These are 
the four keys clustered together just to the left of the 
thumbwheels: ZOOM, PAN, VIEW, NEXTVIEW (and their 
SHIFTed versions, NORMAL, OVERVIEW, RESTORE, and 
BORDER). 



The LOCK-VIEWING-KEYS: command • 
the four grouped keys to be used. 



E cRJ0 — allows 



The LOCK-VIEWING-KEYS: 1 command — E cRJ1 — has 
the following effects: 

• If the terminal is in framing mode (that is, if the light on 
the ZOOM key or the PAN key is turned on), then the 
terminal is removed from framing mode, just as if the 
operator had pressed the lighted key. 

• The four framing keys are disabled in the same way that 
the KEYBOARD-LOCK: 1 command disables the entire 
keyboard. While these keys are disabled, pressing them 
only sounds the bell and has no other effect. 



The host computer can inquire whether the viewing keys 
are locked by issuing a REPORT-TERMINAL-SETTINGS 
command for the "RJ" op code. The terminal-settings- 
report sent in response to such a command not only tells 
the host whether the viewing keys are locked, but also 
reports whether the terminal is in ZOOM or PAN submode of 
framing mode. 



DEFAULTS 



locking-mode 
as shipped — 
on power-up — 
if omitted — 



ERRORS 



RJOO (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 4113, or a 41 15.) 

RJ1 1 (Level 2): Invalid locking-mode (must be or 1 ). 



REFERENCES 

LOCK-KEYBOARD command 
REPORT-TERMINAL-SETTINGS command 
Terminal-settings-report message type 
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MAP-INDEX-TO-PEN Command 



OPTION 10 



Host Syntax 




Setup Syntax 



PMAP s p port index-to-be-mapped pen-ID-number 



PARAMETERS 



DESCRIPTION 



port 

Specifies the RS-232 peripheral port for which color 
indices are to be mapped to plotter pen numbers. Valid 
devices are: 

P0 
P1 
P2 

index-to-be-mapped (-1 to 255). 

Specifies the color index that is assigned to the specified 
pen. 



to 255 a particular color index 

pen-ID-number (0 to 255). 

Specifies the pen that will draw the specified color index. 





1 to 255 



no pen 

a particular pen 



This command assigns a specific color index to a particular 
plotter pen number at the specified peripheral port. When 
graphic data is drawn on the plotter at that port, all with that 
color index will be drawn using the specified pen. 



Peripheral Port Identifier. The peripheral port identifier is a 
string parameter identifying the peripheral port to which the 
plotter is connected. This string may be "P0:", "P1 :", 
or"P2:". 



Index-to-be-Mapped. This parameter specifies the color 
index which is to be assigned to the particular plotter pen. If 
this parameter is -1 , it means that all color indices are 
assigned to that pen. 



Pen-ID-Number. This parameter specifies to which pen the 
color index is to be assigned. Values of 1 to N name a partic- 
ular plotter pen. Here, N is the maximum number of pens for 
the plotter in question. For a standard 4662 plotter, N = 1 . 
For a 4662 equipped with Option 31 , N = 8. For a 4663 
plotter, N = 2. 
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Pen number means "no pens." For example, selecting 
index 2 and pen zero causes color index 2 to be assigned to 
no pen. (Lines drawn in color index 2 will not be plotted.). 

Assigning a color index to one pen automatically deletes 
that color index from any other pen to which it may previ- 
ously have been assigned. 



Examples. 

MAP-INDEX-TO-PEN 
MAP-INDEX-TO-PEN 

MAP-!NDEX-TO-PEN 



MAP-INDEX-TO-PEN 



'P0:",-1,0 Use no pens. 

'P0:",-1,3 Map all indices to 
pen number 3. 

'PC - ". 5,0 Do not draw color 

index 5. (Color index 
5 is not assigned to 
any of the pens at 
peripheral port 
zero.) 

Color index 5 is 
assigned to pen 
number 2 at periph- 
eral port zero. 



'PO:", 5,2 



DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PI1 1 

index-to-be-mapped 

as shipped 1 

on power-up 1 

if omitted — 

pen-ID-number 
as shipped — 1 
on power-up — 1 
if omitted — 



ERRORS 

PI00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PI02 (Level 3): No memory is available for the index map. 
(To guarantee an available index map for 
a particular peripheral port, the MAP- 
INDEX-TO-PEN command should be 
issued immediately after power-up, or 
immediately after a RESET command.) 

PI11 (Level 2): Invalid port identifier (must be PO:, P1: 
or P2:). 

PI12 (Level 3): Out of memory while parsing the 
parameter. 

PI13 (Level 2): Port busy. 

PI21 (Level 2): Invalid index (must be in the range from 
-1 to 255) 

PI31 (Level 2): Invalid pen number (must be in the range 
from to 255). 

REFERENCES 

PLOT command 
SET-LINE-INDEX command 
SET-TEXT-INDEX command 
SET-SURFACE-GRAY-LEVELS command 
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Host Syntax 



E cLF xy.position 



Setup Syntax 



E cLF s p position 



PARAMETERS 



DEFAULTS 



position (41 1 2, 41 1 3: X = to 4095, Y = to 4095; 
41 15: X = -2 31 to 2 31 =1 , Y = -2 31 to 2 31 -1). 
The position in terminal space to which the graphic beam 
is moved. 



position 

as shipped — none 
on power-up — none 
if omitted — (0,0) 



DESCRIPTION 



ERRORS 



The MOVE command moves the graphic beam position to 
the point in terminal space specified by the command's 
parameter and resets the dashed-line generator to the 
beginning of the current line-style pattern. 

The MOVE has two formats: explicit and implicit. The 

QA|Jll^ll l\Jl 11 iai IO ^1—1 AJf . IL UUC& I IUI UW|JCl IU VI I Wl \Jt iaii^S 

the terminal mode. 

The implicit format is G sxy, which puts the terminal into 
Vector mode, and sets the move/draw flag to draw. 



LF11 (Level2): lnvalidpos///on(4112,4113,4114,4116: 
X and Y both range from to 4095; 4115: 
X and Y both range from -2 31 to 2 31 -1). 

REFERENCES 

DRAW command 

ENTER-VECTOR-MODE command 
SET-LINE-STYLE command 
SET-4014-LINE-STYLE command 
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NEXTVIEW Key 



4112,4113,4115 NORMAL Key 



4112,4113,4115 



DESCRIPTION 



DESCRIPTION 



The NEXTVIEW key exists only on the 41 12, 41 13, and 
41 1 5 terminals. It does not auto-repeat. 

This key is useful only when multiple views have been 
defined (by means of SELECT-VIEW commands). Pressing 
NEXTVIEW saves the status of the current view and selects 
the next higher-numbered view. Pressing NEXTVIEW 
while holding the CTRL key down selects the next lower- 
numbered view. The selected view's border is blinked once. 

If the terminal is in "frame mode," (that is, if the light in the 
PAN key or the ZOOM key is on), then pressing NEXTVIEW 
does not alter the location of the framing box — the 
"proposed new window" — in terminal space. (That is, the 
box frames the same window in the new view). 



REFERENCES 



The NORMAL key (the SHIFTed version of the ZOOM key) 
exists only on the 41 1 2, 41 1 3, and 41 1 5 terminals. 

This key has effect only when the terminal is in "framing 
mode," that is, when the framing box is displayed and the 
light on the ZOOM key or the PAN key is turned on. 

Pressing the NORMAL key returns the shape (i.e., the ratio 
of height to width) of the framing box to that of the original 
window for that view. The size of the adjusted framing box is 
determined by the average of the ratios of the X and Y 
extents of the original window and framing box. The location 
of the framing box, defined by the location of its center, is 
only changed if the new framing box would extend outside 
terminal space unless moved. This operation may result in 
defining the framing box larger than terminal space, so that 
when the view key is pressed error KW21 (Level 2) is 
detected. 



SELECT-VIEW command 
PAN key 
ZOOM key 



Here, "original window" means the window defined by the 
most recent set-window command for that view. (The oper- 
ator's manipulation of the viewing keys does not count.) If 
no such set-window command has been issued, then the 
original window is the window in effect when the view was 
created. 



This key does not auto-repeat. 

REFERENCES 

SET-WINDOW command 
ZOOM key 
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OVERVIEW Key 



4112,4113,4115 



DESCRIPTION 

The OVERVIEW key exists only on the 41 12, the 41 1 3, and 
the 41 1 5. It does not auto-repeat. 



OVERVIEW Key. Pressing the OVERVIEW key (the 
SHIFTed version of the PAN key) causes the following 
to occur: 

• The current view's viewport is erased. 

• On a 41 1 2, 41 1 3, 41 1 4, and 41 1 6, the window from x = 
to x = 4095, and y = to y = 3071 is selected. 

• On a 41 1 5, the partial overview window (as set by the 
SET-OVERVIEW-WINDOW command)is selected. 

• If the terminal is in "framing mode" (that is, if the PAN 
key iight or the ZOOM key light is on), the terminal 
remains in framing mode and the framing box show- 
ing the "proposed new window" remains at the same 
position in terminal space. 



keys) has an effect similar to that of the OVERVIEW key. How- 
ever, on a 41 12, 41 13, 41 14, or 41 16, CTRL-OVERVIEW 
selects the window from x = to x = 4095, and from y = 
to y = 4095 and on a 41 15, CTRL-OVERVIEW selects 
the full overview window (as set by the SET-OVERVIEW- 
WINDOW command). 



Effect of View Display Clusters. In the 41 1 2, 41 1 3, and 

4115, it is possible to group several views togeti ier in a 
"view display cluster." (See the description of the SET- 
VIEW-DISPLAY-CLUSTER command for details.) If this is 
done, then pressing OVERVIEW or CTRL-OVERVIEW 
affects not only the current view, but also all other views in 
the same display cluster as the current view. 

The Operator's Manual for your terminal 
SET-OVERVIEW-WINDOW command 
SET-VIEW-DISPLAY-CLUSTER command 



CTRL-OVERVIEW Key. Pressing CTRL-OVERVIEW (press- 
ing the PAN key while holding down the SHIFT and CTRL 
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PAGE Command 



Host Syntax 




DESCRIPTION 

The effect of the PAGE command depends on whether the 
dialog area is enabled. 



If the Dialog Area is Enabled. If the dialog area is enabled, 
the page command (or pressing the PAGE key) erases the 
current view and redraws any visible segments. On the 
41 14 and 41 16, the entire screen is erased, and all visible 
segments are redrawn. On the 41 1 2, 41 1 3, and 41 1 5, only 
the viewport or view cluster for the current view is erased, 
and only segments visible in that view or view cluster are 
redrawn. 



2. The effect of any ENABLE-4010-GIN command is 
cancelled. (That is, the terminal exits 401 0-style 
GIN mode.) 

3. In the 41 1 4 and 41 1 6, the current margin is reset to 
margin one. 

4. The graphic beam position and the alpha cursor are 
moved to X = 0,Y = 3071 on the 41 12, 41 13, 41 14, 
and 4116, and the home position on the 41 1 5 (the 
home position corresponds to the window set by the 
SET-OVERVIEW-WINDOW command). 

5. The terminal enters Alpha mode. 



If the Dialog Area is Disabled. With the dialog area dis- 
abled, the terminal emulates earlier TEKTRONIX terminals 
which lack a dialog area. As before, the current view is 
erased and all visible segments are redrawn. In addition, 
the following actions occur: 

1 . The current line style and line width are reset to (solid, 
narrow lines). 



REFERENCES 

4110 Series Host Programmer's Manual 
ENABLE-DIALOG-AREA command 
PAGE key 
RENEW command 

SET-OVERVIEW-WINDOW command 
SET-VIEW-DISPLAY-CLUSTER command 
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PAGE Key 



PAN Key 



4112,4113,4115 



DESCRIPTION 



DESCRIPTION 



Pressing the PAGE key has the same effect as issuing a 
PAGE command. This key does not auto-repeat. 



REFERENCES 

PAGE command 



The PAN key exists only on 41 12, 41 13, and 41 15 terminals. 
It does not auto-repeat. 

If the light in the PAN key is not on, pressing this key turns 
on that light and puts the terminal in "frame mode," in the 
"pan submode." (If the terminal is already in "frame mode" 

— that i<5 if the lioht in the 700M key i«s nn — then the ter. 

minal stays in frame mode, but leaves the "zoom submode" 
and enters the "pan submode.") 

While in PAN submode, the terminal displays a "framing 
box" with a cross in its center. (The cross's vertical line is 
0.5 of the framing box's height; the cross's horizontal line 
is 0.5 of the framing box's width.) This framing box indicates 
the boundary of a "proposed new window" in terminal 
space. (To put the proposed new window into effect, the 
operator would press the VIEW key.) 

While in pan submode of frame mode, moving the thumb- 
wheels causes the proposed new window to move about in 
terminal space; the framing box moves too, to show the 
location of the proposed new window. Moving the horizontal 
thumbwheel moves the framing box to the right or left; mov- 
ing the vertical thumbwheel moves it up or down. 

Pressing the SHIFT key while moving either thumbwheel 
causes the framing box to move more slowly. This allows for 
finer adjustments in the position of the framing box. 

To exit framing mode, press the PAN key again; the light on 
the key will turn off, and the terminal will exit framing mode. 
To leave PAN submode and enter ZOOM submode, press 
the ZOOM key; the PAN key light will turn off, and the 
ZOOM key light will turn on. 



REFERENCES 

ZOOM key 
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Panel-Definition Syntactic Construct 



4112,4113,4115 



SYNTAX 



panel-definition = panel-boundary-definition 

\panel-boundary-definition...] 
END-PANEL 



panel-boundary-definition 



tJuiiiiiicxi y-pUii it — 



BEGIN-PANEL-BOUNDARY 
[boundary-point. ..] 



< MOVE 
] DRAW 
I DRAW-MARKER , 



DESCRIPTION 

To draw a panel: 

1 . Before the panel-definition, send a SET-PANEL- 
FILLING-MODE command to specify whether the panel 
boundary is to be drawn, and how its interior is to be 
filled. 

2. Send a BEGIN-PANEL-BOUNDARY command to the 
terminal. This begins the panel-definition. The graphic 
beam position moves to the position specified by the 
BEGIN-PANEL-BOUNDARY command. 

3. Send a series of boundary-points to specify the ver- 
tices of the panel boundary. 

4. DRAW-RECTANGLE commands may be used to define 
rectangular boundaries (see the DRAW-RECTANGLE 
command for further details). 

5. Send an END-PANEL command. END-SEGMENT, 
BEGIN-NEW-SEGMENT, BEGIN-HIGHER-SEGMENT, 
and BEGIN-LOWER-SEGMENT also end apanel- 
defmition. 

Considerations in Panel-Definitions 

Within a panel-boundary-definition, the boundary-points 
can be specified by MOVE, DRAW, or DRAW-MARKER com- 



mands. If the panel boundary is drawn, all of its edges are 
drawn, regardless of any interspersed moves or markers. 
No markers are drawn at the vertices of the boundary. 

Alphatext is not permitted within a panel-definition. If a 
panel is being defined when alphatext is received and the 
dialog area is disabled, an error is detected and the panel 
definition is terminated. 

Graphtext is also not allowed within a panel-definition. An 
error is detected, and if the error message is printed in the 
graphics area, alphatext in the message causes another 
error and the panel is closed. 

After the END-PANEL command, the graphic beam position 
is updated to the point specified by the xy parameter in the 
last BEGIN-PANEL-BOUNDARY command. 



REFERENCES 

BEGIN-PANEL-BOUNDARY command 
DRAW command 
DRAW-MARKER command 
DRAW-RECTANGLE command 
END-PANEL command 
MOVE command 

SET-PANEL-FILLING-MODE command 
SET-FILL-PATTERN command 
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PIXEL-COPY Command 



4112,4113,4115 



Host Syntax 



E cRX mV.destination-surface xy.destination-lower-left-corner xy.first-source-corner 
xy :second-source-corner 



Setup Syntax 



E cRX s p destination-surface destination-lower-left-corner first-source-corner 
second-source-corner 



PARAMETERS 



DESCRIPTION 



destination-surface (41 1 2: -1 to 3; 41 1 3: -1 to 4; 
41 1 5: -1 to 8) 
Names the surface to which pixels are to be copied. 

-1 super surface: all bit planes on all defined 

surfaces (see Appendix D for details pertain- 
ing to the super surface). 

the current surface as defined by the 

last BEGIN-PIXEL-OPERATIONS command. 

1 to 8 the surface with the specified number. 

destination-lower-left-corner (41 1 2, 41 1 3: X = to 639, 

Y = 0to479;4115:X = Oto 
1279,Y = Oto 1023) 
Names the lower-left corner of the region on the destina- 
tion surface to which pixels are to be copied. 

first-source-corner (41 1 2, 41 1 3: X = to 639, Y = to 479; 
4115:X = 0to1279,Y = 0to1023) 
One comer of a rectangular region on the current pixel 
surface. The pixel at this corner is copied to the lower-left 
corner of the destination region. 

second-source-corner (41 1 2, 41 1 3: X = to 639, Y = to 
479;4115:X = 0to1279,Y = Oto 
1023) 
The corner opposite the first-source-corner in the 
"source" rectangular region. 



The PIXEL-COPY command copies pixels from a rectan- 
gular region on the current pixel surface in raster memory 
space to a rectangular region (of the same dimensions) 
elsewhere in raster memory space. 

Here, "the current pixel surface" means the surface speci- 
fied in the most recent BEGIN-PIXEL-OPERATIONS com- 
mand. Pixels are copied to the destination region using the 
ALU mode specified in the most recent BEGIN-PIXEL- 
OPERATIONS command. 

In this command, all xy coordinates specify pixel positions 
in raster memory space. 



Destination Surface. The first parameter specifies to which 
writing surface the pixels are to be copied. The special 
surface number -1 designates a "super surface" consisting 
of all bit planes of all defined surfaces. See Appendix D if 
you intend to use the super surface. Surface number 
represents the current pixel surface as set in the most 
recent BEGIN-PIXEL-OPERATIONS command. 



Destination Lower Left Corner. The first xy parameter 
specifies the lower left corner of a rectangular region on the 
destination surface in raster memory space. This destina- 
tion region is the same width and height as the source 
region specified by the source corners, as limited by the 
edge of pixel space. 
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Source Corners. The last two xy parameters are opposite 
corners of a rectangular region on the current pixel surface. 
The PIXEL-COPY command copies each pixel in this rec- 
tangular region onto a corresponding pixel in the destina- 
tion region on the destination surface (or on all surfaces, if 
the destination surface number is -1 .) 

The two "source corners" need not be the lower left and 
upper right corners, respectively, of the source region. How- 
ever, if they are not, then a "mirror" or "inversion" opera- 
tion is performed when copying. That is, the pixels written to 
the destination region may form a mirror image, or an 
inverted image, of the picture formed by the pixels in the 
source region. The pixel at the first source corner is copied 
onto the pixel at the lower left corner of the destination 
region. The pixel at the second source corner is copied onto 
the pixel at the upper right corner of the destination region. 

To facilitate "mirror" and "inversion" operations, the prelim- 
inary pixel-copy in place operation is not done if the follow- 
ing conditions are met: 

• The destination-surface is the same as the source 
surface. 

• The destination-lower-left-corner is the same as the 
lower-left source corner. 

• The first-source-corner is not the lower-left corner of the 
source region, and the second-source-corner is not the 
upper-right corner of the source region. 



DEFAULTS 

destination-surface 
as shipped — none 
on power-up — none 
if omitted — 



destination-lower-left-corner 
as shipped — none 
on power-up — none 
if omitted — (0,0) 

first-source-corner 
as shipped — none 
on power-up — none 
if omitted — (0,0) 

second-source-corner 
as shipped — none 
on power-up — none 
if omitted — (0,0) 



ERRORS 

RX00 (Level 0): 

RX10 (Level 2): 

RX11 (Level 2): 

RX21 (Level 2): 

RX31 (Level 2): 

RX41 (Level 2): 



Unrecognized command. (The terminal is 
nota4112,4113or4115.) 

The specified destination-surface does 
not exist. 

Invalid destination-surface. (41 12: -1 to 3; 
4113:-1 to 4; 41 15: -1 to 8.) 

Invalid destination-lower-left-corner. 
(4112,4113:X = 0to639,Y = 0to479; 
4115:X = 0to1279,Y = 0to1023.) 

Invalid first-source-corner. (4112,4113: 
X = 0to639,Y = 0to479;4115:X = 
to 1279, Y = to 1023.) 

Invalid second-source-corner. (4112, 
4113:X = 0to639,Y = 0to479;4115: 
X = 0to1279,Y = 0to1023.) 



REFERENCES 

BEGIN-PIXEL-OPERATIONS command 
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PLOT Command 



OPTION 10 



Host Syntax 



E cPL string-separator Aev\ce:destination 



Setup Syntax 




PARAMETERS 

separator 

Must be the empty string or TO 



ucounir i ivsft 

The PLOT command saves segments that are visibie in the 
current view to the specified destination. 



destination 

Specifies the destination for the plot. Valid specifiers are 
the devices and filenames: 



P0 
P1 
P2 

HO: 



The peripheral ports (Option 10) 



The host computer 

F0:filename Files on the disk options (Options 42, 

F1 :filename 43, and 45) 

filename 

S0:filename — 

Z7:filename 



DM: 



The DMA interface (Option 3A) 



41 1 4, 41 1 6. In the 41 1 4 and 41 1 6, all currently visible seg- 
ments are sent to the destination. 



4112, 4113, 4115. In the41 12, 41 13, and 41 15, SET- 
WINDOW and SET-VIEWPORT commands are sent prior to 
the visible segments. When the destination is a peripheral 
port with a plotter driver assigned to it, segments are 
clipped to the designated window and viewport. 



Destination. The destination specifier may be any physical 
device except the Option 9 color hardcopy interface port 
(HC:), such as a disk file, a peripheral port, or the host. 



Window-Viewport Transform. In the 41 1 2, 41 1 3, and 4115, 
only the part of the picture within the current window is 
plotted. (This is the part of the current view which is visible 
in that view's viewport.) Lines passing through the window 
boundaries are properly clipped. (Thus, if the output device 
is a peripheral port with a plotter attached, the plotter pen is 
not driven off the paper.) If multiple views exist, only the 
current view's segments are sent to the output device. 
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NOTE 

When a view is drawn on a plotter in response to 
the plot command, segments may appear at slightly 
different locations that when those same segments 
are drawn with the save command. This is because 
the plot command includes SET- WINDOW and 
SET- VIEWPORT commands in the data being sent 
to the peripheral port, while the save command 
does not. 

In a 41 12, 4113, 4114, and 41 16, to make segments 
appear the same when plotted as when saved, you 
should set the view's window to extend from (0,0) 
to (4095,3071) in terminal space and its viewport to 
extend from (0,0) to (4095,3071) in normalized 
screen coordinates. 



Selecting Plotter Pens. If the output device is a peripheral 
port with a plotter protocol assigned, then any SET-LINE- 
INDEX commands within the segments cause the corres- 
ponding plotter pen to be used when drawing subsequent 
graphics. Likewise, any SET-TEXT-INDEX commands 
cause the corresponding pen to be used for subsequent 
alphatext, (The "corresponding pen" is determined by the 
most recent MAP-INDEX-TO-PEN command.) 

DEFAULTS 



ERRORS 

PLOO (Level 0): Unrecognized command. (Option 10 is 
not installed.) 

PL02 (Level 3): Out of memory while attempting DMA 
transfer (Option 9 only). 

PL1 1 (Level 2): Invalid first parameter. (Must be the empty 
string or TO.) 

PL1 2 (Level 3): Out of memory while parsing parameter. 

PL20 (Level 2): Destination device not installed. 

PL21 (Level 2): Invalid destination. 

PL22 (Level 3): Out of memory while parsing parameter. 

PL23 (Level 2): Destination device is busy or is a write- 
protected file. 

PL29 (Level 2): Hardware error on destination device. 

REFERENCES 

COPY command 
MAP-INDEX-TO-PEN command 
SET-EOF-STRING command 
SET-LINE-INDEX command 
SET-REPORT-MAX-LINE-LENGTH command 
SET-TEXT-INDEX command 



separator 

as shipped — none 
on power-up — none 
if omitted — error PL1 1 

destination 

as shipped — none 
on power-up — none 
if omitted — error PL21 
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PORT-ASSIGN Command 



OPTION 10 



Host Syntax 



E cPA dev\ce:port < str'mg-.protocol-identifter 



Setup Syntax 



PASSIGN s p port protocol-identifier 



PARAMETERS 

port 

Specifies the RS-232 peripheral port to which a protocol 
is being assigned. Valid ports are: 

P0 
P1 
P2 

protocol-identifier 

A string specifying the protocol being assigned to the 
peripheral port. Valid values are: 

PPORT 

4643 

4662 

4662/MP 

4662/NT 

4663 

4663/NT 

4663/NB 

KANA 



Drc^DiDTinM 
kWfc/l III I IWIi 

The PORT-ASSIGN command assigns a "device protocol" 
to a particular RS-232 peripheral port. (This command 
requires that Option 10, the Three Port Peripheral Interface, 
be installed in the terminal.) 

The command has two parameters: the port identifier and 
the protocol-identifier. 



Port Identifier. The port identifier is a three-character string 
parameter: "P0:" for peripheral port 0, "P1 :" for peripheral 
port 1 , or "P2:" for peripheral port 2. These identify the 
three RS-232 peripheral connectors on the rear panel of 
the terminal. 



Protocol Identifier. The protocol identifier, another string 
parameter, specifies the communications protocol which 
the terminal will use in communicating with a peripheral 
device connected at the specified peripheral port. Table 
7-16 lists the valid protocol identifiers. 

If a peripheral port is to be the source in a COPY or SPOOL 
command, or if it is to be either the source or the destination 
in a PORT-COPY command, then it is necessary that the 
port have been assigned the PPORT protocol identifier. 

All plotter protocols expect that the attached plotter's device 
address is set to Device A. See the manual for your plotter 
for details on setting this parameter. 
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Table 7-1 6 
PERIPHERAL PORT PROTOCOL IDENTIFIERS 



Protocol 
Identifier 



Meaning 



PPORT 



Assigns a general-purpose RS-232 communications protocol (a protocol that makes no assumptions about the nature of the 
attached device). When data is transferred to this port, the end of the data is marked by appending the port's end-of-file string, 
as set by the SET-PORT-EOF-STRING command. 



4643 



4662 



4662/MP 



4662/NT 



4663 



4663/NB 



4643 Printer. Assigns a communications protocol which is suitable for a TEKTRONIX 4643 Printer. Any c r characters sent to 
this port will be replaced by the port's current end-of-line string, as set by the SET-PORT-EOL-STRING command. As with the 
PPORT protocol, the end of a data transfer is marked with the port's end-of-file string. 



4662 Plotter. Assigns a communications protocol which assumes that the device at this port is a TEKTRONIX 4662 Interactive 
Digital Plotter The plotter's block mode communications protocol is used. When 41 10-series escape-sequence commands are 
sent to this port, the terminal translates tnose commands into plotter commands or ignores them. 



4662 Plotter with Multiple Pens. Similar to the "4662" protocol, except that the 4662 plotter is assumed to be equipped with 
MULTIPLE PENS (Option 31). When 41 1 0-series escape-sequence commands are translated into plotter language commands, 
lines (or text) drawn with different color indices are drawn on the plotter using different pens. (See the description of the 
MAP-INDEX-TO-PEN command for details.) 



4662, No Translation. Similar to 4662 protocol; the device at this peripheral port is assumed to be a 4662 plotter, and the plotter's 
block mode protocol is used. However, there is no translation from 41 10-series escape-sequence commandsto plotter commands. 



4663 Plotter. Assigns a communications protocol which assumes that the device at this port is a TEKTRONIX 4663 Interactive 
Digital Plotter The plotter's block mode communications rotocol is used. When 41 10-series escape-sequence commands are 
sent to this port, the terminal translates these commands into plotter commands. 



4663, No Blockmode. Similar to 4663 protocol; the device at this port is assumed to be a 4663 plotter, and 41 10-series 
escape-sequence commands are translated into plotter commands. However, the plotter's block mode is not used. 



4663/NT 



KANA 



4663, No Translation. Similar to 4663 protocol; the device at this port is assumed to be a 4663 plotter, and the plotter's block 
mode is used. However, there is no translation from 41 10-series escape-sequence commands to plotter commands. 



Katakana, Option 4K. Allows the port to act as a general purpose RS-232 peripheral port, with the ability to transmit and receive 
the JIS 7 bit coded character set. 



DEFAULTS 

port 

as shipped — none 

on power-up — remembered 

if omitted — error PA1 1 



PA13 (Level 2): Port is in use. 

PA21 (Level 2): Invalid protocol-identifier. (Must be 

PPORT, 4643, 4662, 4662/MP, 4662/NT, 
4663, 4663/NB, 4663/NT, or KANA). 

PA22 (Level 3): Out of memory while parsing the parameter. 



protocol-identifier 
as shipped — none 
on power-up — remembered 
if omitted — error PA21 



ERRORS 

PAOO (Level 0): Unrecognized command. (Option 10 
is not installed.) 

PA11 (Level 2): Invalidport. (Must bePO:, P1:,orP2:.) 

PA12 (Level 3): Out of memory while parsing the parameter. 



REFERENCES 

COPY command 

SET-PORT-BAUD-RATE command 
SET-PORT-EOF-STRING command 
SET-PORT-FLAGGING-MODE command 
SET-PORT-PARITY command 
SET-PORT-STOP-BITS command 
PORT-COPY command 
REPORT-PORT-STATUS command 
SPOOL command 
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PORT-COPY Command 



OPTION 10 



Host Syntax 



E cPC dev\ce:source string -.separator dev\ce:destination 



Host Syntax 



PCOPY s p source TO destination 



PARAMETERS 



UbSCRiP I iON 



source 

Specifies the first of two devices between which data 
flows. Valid devices are: 



HO: 

P0: 
P1: 
P2 



The host computer 

The Option 10 RS-232 peripheral ports 



separator-string (Empty String or "TO"). 

Separates the source and destination specifiers. 

destination 

Specifies the second device for the data transfer. Valid 
devices are: 



HO: 

P0 
P1 
P2 



The host computer 

The Option 10 RS-232 peripheral ports 



Like the COPY command, the PORT-COPY command 
establishes a data path between two devices, so that a data 
transfer can take place. Unlike the COPY command, the 
data path is bidirectional: the "destination" device can "talk 
back" to the "source" device during the data transfer. This 
permits the following: 

• The two devices can use a device-dependent "hand- 
shaking" protocol. 

• The source device (typically the host computer) can 
directly query the destination device, and parse the 
destination device's responses. 

The data connection is established by the PORT-COPY 
command; the connection is broken when either device 
sends an end-of-file string (or, in block mode, when the host 
sends a block with the EOF bit set). At the end of the PORT- 
COPY operation, the terminal sends an EOF-string to the 
host port if HO: is either source or destination, and aport- 
EOF-string to the peripheral port. 



NOTE 

If the terminal is armed for block mode, then it 
cannot detect EOF-strings coming from the host 
computer. Thus, if the terminal is armed for block 
mode, but has not yet entered block mode, the only 
way to terminate a port-copy operation involving 
HO: is with the CANCEL key. If you will not be 
using the block mode feature, you should not arm 
the terminal for block mode. 
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Valid specifiers for both source and destination are the host 
computer and the Option 10 RS-232 peripheral ports. 

The data communications protocols in use by the ports at 
the time of the port-copy command will be in effect through- 
out the data transfer. For peripheral ports this must be the 
PPORT protocol. (See the description of the PORT-ASSIGN 
command for details.) 

As with the COPY command, all other terminal activity is 
suspended until the end-of-file is detected. This command 
can be prematurely terminated by pressing the CANCEL 
key on the keyboard. 

DEFAULTS 

source 

as shipped — none 
on power-up — none 
if omitted — error PC1 1 

separator 

as shipped — none 
on power-up — none 
if omitted — error PC21 

destination 

as shipped — none 
on power-up — none 
if omitted — error PC31 



ERRORS 

PC00 (Level 

PC02 (Level 3 

PC10 (Level 2; 

PC1 1 (Level 2 

PC12 (Level 3] 

PC13 (Level 2 

PC21 (Level 2 

PC22 (Level 3 

PC31 (Level 2 

PC32 (Level 3 

PC33 (Level 2 



Unrecognized command. (Option 10 is 
not installed). 

Out of memory while processing 
command. 

Source device does not exist. 

Invalid source (must be HO:, P0:, P1:, 

orP2:). 

Out of memory while parsing the 
paramter. 

Source is busy, or is a peripheral port that 
is not assigned the PPORT protocol. 

Invalid separator. (Must be the empty 
string or TO.) 

Out of memory while parsing the 
parameter 

Invalid destination (must be HO:, P0:, P1 : 
or P2:, and must be different from the 
source port). 

Out of memory while parsing the 
parameter. 

Destination is busy is a peripheral port 
that is not assigned the PPORT protocol. 



REFERENCES 

COPY command 
CANCEL key 
PORT-ASSIGN command 
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PORT-STATUS-REPORT Message Type 



OPTION 10 



SYNTAX 



port-status-report 



[EOM-indicator] 

[sig-char] 

port-ID-code 

[port-information] 

EOM-indicator 



port-ID-code = char-report char-report 



port-information = 



int-report : baud-rate 
int-report : parity 
int-report : stop-bits 
int-report : data-bits 

llli-ie(jv/n .ju*ggtug-unj<*<Z 

int-report -.flagging-" go" -character 
int-report :flagging-"stop" -character 
string-report : device-driver-name 
int-array-report : EOF-string 
int-array-report ; EOL-string 



DESCRIPTION 

If the terminal is equipped with Option 1 0, then it sends a 
port-status-report lo the host computer when commanded 
to do so by a REPORT-PORT-STATUS command. 



EOM-indicator. An EOM-indicator may be sent at the start 
of the port-status-report. This optional EOM-indicator is 
provided because of the terminal's "maximum report line 
length" feature. This EOM-indicator is included in the port- 
status-report only if it is needed to prevent the current maxi- 
mum line length from being exceeded. (See the descrip- 
tion of the SET-REPORT-MAX-LINE-LENGTH command 
for details.) 

If the terminal is not in block mode, the EOM-indicator is the 
current EOL-string — typically, just the c r character. In 
block mode, the EOM-indicator is sent by terminating the 
block and setting the "end-of-message" bit in the block- 
control-bytes. 

When the terminal sends a report to the host, bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 



An EOM-indicator is included at the beginning of a port- 
status-report only if both the following conditions are met: 
(a) At least one character has already been sent on the cur- 
rent line (that is, since the last EOM-indicator). (b) If the line 
were not terminated (with this EOM-indicator), then the 
remainder of the port-status-report could cause the current 
maximum line length to be exceeded. 



Sig-Char. The sig-char (signature character) is provided for 
easier parsing of the report by the host computer. (If graphic 
input is active, the signature character allows the host to 
distinguish this report from GIN reports which are part of a 
GIN -report-sequence) The signature character in the port- 
status-report is the current sig-char for non-GIN reports, as 
set by the most recent SET-REPORT-SIG-CHARS com- 
mand. If the current sig-char is N u, then it is omitted from the 
port-status-report. 



Port-ID-Code. Next comes a two-letter code: P0, P1 , P2, or 
s p s p. This names the RS-232 peripheral port to which the 
port-status-report pertains. These two characters are sent 
to the host as char-reports. 
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A port-ID-code of s p s p indicates that the REPORT-PORT- 
STATUS command had an invalid port-specifier string. If 
that is the case, then the following port-information is 
omitted. 



Port-Information. The port-information consists of a series 
of int-reports, string-reports, and int-array-reports. These 
contain the current values of the peripheral port's parame- 
ters: baud rate, parity, number of stop bits, etc. 

The port-information is sent only if the REPORT-PORT- 
STATUS command had a valid port-specifier string. In other 
words, if the port-ID-code is s p s p, then the port-information 
is omitted. 

The device-driver-name string-report that is part of the port- 
information is always ten characters long. 



Final EOM-lndicator. The port-status-report ends with an 
EOM-indicator. This final EOM-indicator is always sent; it 
helps ensure that the host applications program actually 



receives the port-status-report in a timely manner. (In some 
host operating systems, the user application program does 
not receive a message from the terminal until the terminal 
sends a c r or other end-of-message indicator.) 

If the terminal is not in block mode, the EOM-indicator is 
the current EOL-string; typically, this is just the c h character. 
In block mode, the EOM-indicator is sent by terminating the 
block and setting the "end-of-message" bit in the block- 
control-bytes. 

REFERENCES 

EOM-indicator syntactic construct 
REPORT-PORT-STATUS command 
SET-PORT-BAUD-RATE command 
SET-PORT-EOF-STRING command 
SET-PORT-FLAGGING-MODE command 
SET-PORT-PARITY command 
SET-PORT-STOP-BITS command 
SET-REPORT-SIG-CHARS command 
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Host Syntax 



E cNM mtprompt-mode 


Setup Syntax 


PROMPTMODE s p 


prompt-mode 



KAHAIVI t 1 CHS 

prompt-mode (0, 1 , or 2). 

Turns Prompt mode on and off, and specifies when 
Prompt mode should be turned on. Setup mode param- 
eters are YES and NO. 

NO; turn Prompt mode off. 

1 YES; turn Prompt mode on after the next 
EOM-indicator. 

2 turn prompt mode on immediately. 



DESCRIPTION 

If the parameter is 0, Prompt mode is turned off and any 
characters in the terminal's output queue are transmitted. 

If the parameter is 1 , the terminal does not enter Prompt 
mode until it has encountered an EOM-indicator in the data 
it sends to the host. After sending the EOM-indicator the 
terminal enters Prompt mode. 

If the parameter is 2, the terminal enters Prompt mode 
immediately. 

When the terminal is in Prompt mode, characters are not 
sent to the host, but are placed in the output queue until a 
prompt is received. When a prompt is received, all charac- 
ters up to, and including, the next EOM-indicator are sent. 



VVI ICI I II IC ICI Hill 

queue can be filled while waiting for a prompt from the host 
computer. When the output queue is full, the keyboard is 
temporarily locked and pressing a key simply rings the bell. 
The keyboard unlocks when the terminal receives a prompt 
to empty its output queue, when the host computer sends a 
command to exit Prompt mode, when the CANCEL key is 
pressed, or when the terminal is reset. 



DEFAULTS 

prompt-mode 
as shipped — 
on power-up — ( 
if omitted — 



ERRORS 

NM11 (Level 2): Invalid prompt-mode (must be 0, 1, or 2). 

REFERENCES 

EOM-indicator syntactic construct 
SET-EOM-CHARS command 
SET-PROMPT-STRING command 
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PROTECT-FILE Command 



OPTIONS 42, 43, 45 



Host Syntax 



E cJP dev\ce:file-specifier mtwrite-protect-mode 



Setup Syntax 



PROTECT s p file-specifier write-protect-mode 



PARAMETERS 

file-specifier 

The disk file whose write-protection you are specifying. 
Valid file-specifiers are: 

FO:filename files on Disk Drive FO: 



filename 

F1:filename 

SO:filename- 
Z7:filename 



files on Disk Drive F1: 

files on the Option 45 disk drives 



write-protect-mode (0 or 1). 

The protection you want for the specified file. Setup 
mode parameters are YES and NO. 

NO; unprotects the file. 

1 YES; protects the file. 



DESCRIPTION 

This command sets or clears the write-protect flag on the 
specified file. This operation is distinct from the hardware 
write-protect that is controlled by a notch in the disk and/or 
the front panel switch. 

To protect or unprotect a specific disk file, include both the 
disk drive number and the filename in the string parameter. 

Protected files may not be deleted by the DELETE-FILE 
command or overwritten with a COPY, SPOOL, SAVE, 
PLOT, or DIRECTORY command. A FORMAT-VOLUME 
command can overwrite individual protected files. 



DEFAULTS 

file-specifier 

as shipped — none 
on power-up — none 
if omitted — error JP1 1 

write-protect-mode 
as shipped — 1 
on power-up — 1 
if omitted — 1 



ERRORS 

JP00 (Level 2): 



Unrecognized command. (Disk drive 
option is not installed.) 



JP10 (Level 2): The specified file or disk drive does not 
exist. 

JP11 (Level 2): Invalid file specifier. 

JP12 (Level 3): Out of memory while parsing parameter. 

JP13 (Level 2): Either the specified device is not a disk 

drive, or the file (or entire diskette volume) 
has been write-protected. 

JP19 (Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 

JP21 (Level 2): Invalid write-protect-mode (must be 
OoM). 

REFERENCES 

FORMAT-VOLUME command 
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RASTER-WRITE Command 



4112,4113,4115 



Host Syntax 



E cRP mtnumber-oj -pixels char-array.color-index-codes 



Setup Syntax 



E cRP s p number-of-pixels color-index-codes 



DADXMCTCDC 
rnnnmt. ■ i_ii>_» 

number-of-pixels (0 to 65535). 

Specifies the number of pixels represented in the follow- 
ing char-array. 

color-index-codes 

A char-array whose individual characters hold color 
indices in a packed format. Each code is an ASCII char- 
acter in the range from s p to '; that is, a character whose 
decimal equivalent is in the range from 32 to 96 . 



DESCRIPTION 

The RASTER-WRITE command is one of two commands for 
cn@Qjfyjng +ho color indices of individual n ixe!s. H"he other 
such command is RUNLENGTH-WRITe!) If the RASTER- 
WRITE command occurs between a BEGIN-FILL-PATTERN 
command and an END-FILL-PATTERN command, then it 
specifies the color indices of pixels within a fill pattern; 
otherwise, it specifies the color indices of pixels in the cur- 
rent pixel viewport. 

The data bits embedded within the code characters in the 
color-index-codes array are regarded as a continuous string 
of bits, and are grouped to form color indices for individual 
pixels. The bits are grouped to form color indices according 
to the bits-per-pixel parameter in the most recent BEGIN- 
FILL-PATTERN or BEGIN-PIXEL-OPERATIONS command. 
Which of these two commands is used depends on whether 
the RASTER-WRITE command is specifying bits for a fill 
pattern or for the pixel viewport. 



41 1 2, 41 1 3, Starting at the top left of the fill pattern or the 
current pixel-beam-position, the fill pattern or pixel viewport 
is filled (with color indices) from left to right across a single 
row of pixels. As each color index is loaded into the fill pat- 
tern or pixel viewport, the pixel beam position moves to the 
following pixel on that row. On encountering the right edge 
of the fill pattern or pixel viewport, the pattern position 
or pixel-beam-position moves to the leftmost pixel in the 
row below. 



41 1 5. The 41 1 5 behaves like a 41 1 2 or 41 1 3 when fill pat- 
terns are being defined. However, for each pixel that is to 
be displayed on a 41 15, the parameters of the SET-PIXEL- 
WRITING-FACTORS command determine the area (in 
pixels) covered by each color index, and the direction in 
which the beam position moves. If you do not enter the SET- 
PIXEL-WRITING-FACTORS command, the 41 1 5 terminal 
behaves like a 41 1 2 or 41 1 3. 

Int and Char-Array Parameters 

Figure 7-7 shows how to pack color indices into the 
RASTER-WRITE command's color-index-codes parameter. 

Special Cases 

The ' Character. The special code character ', ASCII deci- 
mal equivalent 96, serves like a c r l f sequence in alphatext: 
it moves the pattern or pixel beam position to the start of the 
following row of pixels. The ' code is not included in the 
pixel count. 
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Too Many Color Indices. If more color indices are sent in 
the color-index-code array than it takes to fill the fill pattern, 
that fill-pattern-definition is ended. There is no need, in this 
case, for an END-FILL-PATTERN command. Excess color 
indices within the same RASTER-WRITE command are 
ignored. 

If the RASTER-WRITE command is sending color indices to 
the current pixel viewport, the pixel beam position "wraps 
around" from the last pixel in the bottom row of the pixel 



viewport to the first pixel in the top row of that viewport, and 
the pixel loading continues. 

One, Two, or Three Bits Per Pixel. If the bits-per-pixel 
parameter in the BEGIN-PIXEL-OPERATIONS or BEGIN- 
FILL-PATTERN is 1 , then six color indices (each consisting 
of a single bit) will fit into each code character. If bits-per- 
pixel is 2, then three color indices fit into each code charac- 
ter. If bits-per-pixel is 3, then two color indices fit into each 
code character, as shown in Figure 7-7. 



X -L UJ.UO— ^Cl — ^.LACL J. O 



\r +-v«^ ^> ^ "I /^ v» ■? vi /A ■* /-> ^ c O O 



-5 +. v 

Jj i<i 

2, 3, 2, 7 into a RASTER-WRITE command as follows: 



1. Express the color indices as 3-bit binary numerals: 








I 


2 


3 

1 


2 

\ 


7 

I 


000 


000 


010 


011 


010 


111 



2. Group the binary bits into 6-bit groups: 



000 



000 



010 



011 



.010 



111. 



000.000 



010011 



010111 



Add 32 (binary 100000) to these 6-bit binary numerals 
to form 7-bit ASCII characters: 



1000000 


01010011 


0101.0111 


I 


\ 


t 


S P 


3 


7 



Issue a RASTER-WRITE command. The command's first 
parameter is int: 6, because the command holds 6 color 
indices. The second parameter is a char-array holding 



the characters 



RASTER-WRITE 



s p , 3, and 7. 
E cRP int: 6 char-array s p , 3,7 
E cRP 6 3 s » 37 



Figure 7-7. Packing Color Indices into the RASTER-WRITE Command. 
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Four Bits Per Pixel. In the 41 1 3 and 41 1 5 the bits-per-pixel 
parameter may be set to 4. In that case, one and a half color 
indices fit into each code character. That is, every pair of 
codes holds three color indices. Figure 7-8 shows the pack- 
ing scheme. 

Six Bits Per Pixel. If the bits-per-pixel parameter in the 
BEGIN-PIXEL-OPERATIONS or BEGIN-FILL-PATTERN 
command is six, then the terminal interprets each code 



character as containing only one color index. In the 41 1 2, 
the least-significant three bits of the code character deter- 
mine a color index in the range from to 7. In the 41 1 3, the 
least-significant four bits are used, permitting color indices 
in the range from to 15. In a 41 15, all six bits determine the 
color index, allowing indices of to 63. 

In a 41 1 2 or 41 1 3, if bits-per-pixel = 6, you can represent 
each color index in the range from to 7 with a single ASCII 



If the bits-per-pixel is 4, then the color indices 0, 0, 
2, 3, 12, 15 are packed into a RASTER-WRITE command as 
follows : 



1 



3. 



Express the color indices as 4-bit binary 
numerals: 









2 


3 


12 


15 


i 


I 
1 


t 


I 
t 


I 
+ 


t 


0000 


0000 


0010 


0011 


1100 


1111 



Group the binary bits into 6-bit groups 



,0000 OQpO 



0010, ,0011 



1 1,00 



1111 



000000 



000010 



001111 



001111 



Add 32 (binary 100000) to these 6-bit binary 
numerals to form 7-bit ASCII characters: 

0100000 0100010 0101111 0101111 

t \ I \ 

S p ft / / 

Issue the RASTER-WRITE command. The command's 
first parameter is int: 6, because the command 
holds 6 color indices. The second parameter is a 
char-array holding the characters s p , " , 
/, and /. 



RASTER-WRITE 



e cRP64 s p"// 



Figure 7-8. A Raster-Write Command With Four Bits Per Pixel. 
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character in the range from to 7. For the 41 13 and 41 15, 
color indices in the range from to 1 5 can be represented 
as ASCII characters in the range from to ?. (Coinciden- 
tally, these are the same as the int parameters for numbers 
in the range from to 1 5.) 



Eight Bits Per Pixel. On a 41 1 5, the bits-per-pixet can be 
set to 8. If this is the case, each code character holds three- 
fourths of a pixel specification. Figure 7-9 shows the pack- 
ing scheme for eight-bit pixels. 



DEFAULTS 

number-of-pixels 
as shipped — none 
on power-up — none 
if omitted — error RP1 1 

color-index-codes 
as shipped — none 
on power-up — none 
if omitted — 



If the bits-per-pi xel is 8, then the color indices 0, 64, 
and 100 are packed into a RASTER-WRITE command as follows: 

1. Express the color indices as 8-bit binary numerals: 
64 100 

1 I I 

00000000 01000000 01100100 

2. Group the binary bits into 6-bit groups: 

.oooooqpo 01000000 oijooioo, 



000000 000100 



000001 100100 



Add 32 (binary 100000) to these 6-bit binary 
numerals to form 7-bit ASCII characters: 

0100000 0100100 0100001 1000100 

I \ \ \ 

s p $ ! D 

Issue the RASTER-WRITE command. The command's first 
parameter is 3, because the command holds three color 
indices. The second parameter is a char-array holding 
the characters s p , $, ! , and D. 

RASTER-WRITE = e cRP34 s p$!D 



Figure 7-9. A Raster-Write Command With Eight Bits Per Pixel. 
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ERRORS REFERENCES 

RPOO (Level 0): Unrecognized command (The terminal is BEGIN . FILL . PATTERN command 

not a 41 1 2, 41 13, or 41 1 5.) BEGIN-PIXEL-OPERATIONS command 

RP1 1 (Level 2): Invalid number-oj '-pixels. (Must range RUNLENGTH-WRITE command 

from to 65535.) SET-PIXEL-VIEWPORT command 

RP21 (Level 2): There are too many or too few pixels in SET-PIXEL-WRITING-FACTORS command 

the code-array, or invalid code(s) are 

present (range is from ADE 32 to 96). 

RP22 (Level 3): Out of memory while parsing the 
parameter. 
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Real Parameter Type 



SYNTAX 



real = \n\:mantissa mt:power-of-two 



COMPONENTS 

mantissa. 

An integer, represented as an int parameter. 

power-of-two. 

An int telling the power of two by which the mantissa is 
multiplied. 

DESCRIPTION 

To send a real number to the terminal (as a parameter for 
one of its commands), you represent it in the form "A times 
two to the Bth power," where A and B are integers. Send A 
first, and then B, packed in the int parameter format. 



Examples. The number 1 .5 may be expressed as 3 times 
1 /2, or 3 times 2 to the power -1 . Here, A = 3 and B = -1 ; 
hence 

real: 1.5 = int: 3 int: -1 = 3! 

The number pi may be approximated as 25736/8192, or 
25736 times 2 to the power -13. Here A = 25736 and 
B = -13; hence 

real: pi = int: 25736 int: -13 = YH8- 

A Sample Routine. Figure 7-1 shows a PASCAL proce- 
dure to issue real parameters to the terminal. 

REFERENCES 



Int parameter type 
Real-report parameter type 
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PROCEDURE Send Real (Real Number : REAL) ;{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ } 
{} 

CONST 

Epsilon = 0.00006104; {** 2 to the power -14 **} 

VAR 

Mantissa, Exponent : IntType ; 
Negative : BOOLEAN; 

BEGIN 

{ * * We '11 work on positive numbers...**} 
Negative := (RealNumber < 0.0); 
IF Negative 

THEN RealNumber := -RealNumber; 
{** Initialize Exponent. **} 

Exponent := 0; 
{ ** If there's a fractional part, we need more precision.. **} 
WHILE (RealNumber > (Trunc ( RealNumber ) + Epsilon)) 
AND_(Trunc(RealNumber) < 16383 ) DO 
BEGIN 

RealNumber := RealNumber * 2.0; 
Exponent := Exponent - 1; 
END; 
{** If the number's a large integer, we need a pos. exponent **} 
WHILE (RealNumber > 32767.0) DO 
BEGIN 

RealNumber := RealNumber / 2.0; 
Exponent := Exponent + 1; 
END; 
{** Okay, now ship off the Mantissa and Exponent. **} 
Mantissa := Trunc( Real Number + 0.5); 
IF Negative 

THEN Mantissa := -Mantissa; 
{ ** Ship off the Mantissa and Exponent. **} 
Send In t( Mantissa) ; 
Sendlnt(Exponent) : 
END; 

{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 



Figure 7-10. Sending a Real Parameter in PASCAL. 
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Real-Report Message Type 

SYNTAX 



real-report = \r\l-reporX.mantissa 

M-reporkpower-of-two 



DESCRIPTION • The terminal sends real-reports as pairs of int-reports, 

whereas the host computer sends reals as pairs of ints. 

The real-report parameter type resembles the real parame- 
ter type, but with these differences: ___________ 

• Real-reports are used by the terminal to send real num- 
bers to the host computer, whereas real parameters are R ea i parameter type 
used by the host computer to send real numbers to the Int-report parameter type 
terminal. 
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RECTANGLE-FILL Command 



4112,4113,4115 



Host Syntax 




Setup Syntax 



E cRR s p first-corner second-corner fill-index 



PARAMETERS 

first-corner (41 1 2, 41 1 3: X = to 639, Y = to 479; 
4115:X = 0to1279,Y = 0to1023). 
Specifies one corner of a rectangle in raster memory 
space. 

second-corner (41 1 2, 41 1 3: X = to 639, Y = to 479;). 
4115:X = to 1279, Y = to 1023). 
Specifies the opposite corner of that rectangle. 

fill-index (0 to 32767). 

The color index with which the rectangle is to be filled. 

DESCRIPTION 

The specified rectangle, on the current surface, has all its 
pixels set to the color index specified in the int parameter. 
Here, "current surface" means the surface specified in the 
most recent BEGIN-PIXEL-OPERATIONS command. The 
color indices are written into the raster memory using the 
ALU mode specified in that same BEGIN-PIXEL- 
OPERATIONS command. 

Two opposite corners of the rectangle are specified by the 
two xy parameters. 

If the first and second corners of the rectangle have the 
same X-value, then the rectangle filled will be one pixel 
wide. Likewise, if the first and second Y-values are the 
same, then the rectangle filled will be one pixel high. 



DEFAULTS 

first-corner 

as shipped — none 
on power-up — none 
if omitted — (0,0) 

second-corner 

as shipped — none 
on power-up — none 
if omitted — (0,0) 

fill-index 

as shipped — none 
on power-up — none 
if omitted — 



ERRORS 

RR00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RR11 (Level 2): \ma\\6 first-corner coordinates. 

(4112,4113:X = 0to639,Y = 0to479; 
4115: X = to 1279, Y = 0to1023.) 

RR21 (Level 2): Invalid second-corner coordinates. 

(4112,4113:X = 0to639,Y = 0to479; 
4115: X = 0to1279,Y = 0tOl023.) 

RR31 (Level 2): \ma\\6 fill-index (must range from to 
32767.) 



REFERENCES 

BEGIN-PIXEL-OPERATIONS command 
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RENAME-FILE Command 



OPTIONS 42, 43, 45 



Host Syntax 



E cJR dev\ce:old-filename stiing:separator device.new-filename 



Setup Syntax 




PARAMETERS 



DESCRIPTION 



old-filename 

The file name you want to change. Valid formats are: 



FO:filename 

filename 



a file on Disk Drive FO: 



F1:filename a file on Disk Drive F1: 

SO:filename — a file on one of the Option 45 devices 
Z7:filename 

separator 

The empty string or TO. 

new-filename 

The name with which you want to replace the old- 
filename. Valid formats are: 



FO:filename 
filename 



a file on Disk Drive FO: 



F1 filename a file on Disk Drive F1: 

SO:filename — a file on one of the Option 45 devices 
Z7:filename 



This command renames the file specified by the old- 
filename parameter to the name specified by the new- 
filename parameter. 

The two file specifiers must agree in their device fields. If 
this field is omitted, it is assumed to be FO: or, if neither 
Option 42 nor 43 is installed, but Option 45 is, the first 
device connected to the Option 45 interface. 

The file is not renamed and an error occurs if the file is 
write-protected, if the old-filename does not exist, if a file 
already exists with the new-filename, or if the disk unit is not 
present. 

DEFAULTS 

old-filename 

as shipped — none 
on power-up — none 
if omitted — error JR1 1 

separator 

as shipped — none 
on power-up — none 
if omitted — error JR21 



new-filename 

as shipped — none 
on power-up — none 

if omitted — error JR31 
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ERRORS 

Unrecognized command. (Disk drive 
option is not installed.) 

The specified file does not exist or the 
device is not installed. 

Invalid old-filename specifier. 

Out of memory while parsing parameter. 

The specified file is write-protected. 

Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 

JR21 (Level 2): Invalid separator string (must be empty 
string or TO). 



JROO 


(Level 0): 


JR10 


(Level 2): 


JR11 


(Level 2): 


JR12 


(Level 3); 


JR13 


(Level 2): 


JR19 


(Level 2); 



JR22 
JR30 



JR31 
JR32 



(Level 3): 
(Level 2): 



(Level 2): 
(Level 3): 



Out of memory while parsing parameter. 

The device specified is not installed or is 
different from the device specified in 
parameter 1 , or the new-filename is 
already present. 

Invalid new-filename specifier. 

Out of memory while parsing parameter. 



REFERENCES 

PROTECT-FILE command 
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RENAME-SEGMENT Command 



Host Syntax 




Setup Syntax 



E cSR s p old-segment-number new-segment-number 



PARAMETERS 



ERRORS 



old-segment-number (1 to 32767). 

Number of the segment being renamed. 

new-segment-number (1 to 32767). 
New name for the segment. 



DESCRIPTION 

This command renames (renumbers) an existing segment. 
The segment number is changed to the new-segment- 
number, shown above as the second int parameter. If a seg- 
ment with the new segment number already exists, an error 
occurs and the segment is not renamed. 

Valid segment numbers range from 1 to 32767. 

DEFAULTS 

old-segment-number 
as shipped — none 
on power-up — none 
if omitted — error SR1 1 



SR02 (Level 3): Out of memory while renaming a segment 
(41 14, 41 15, and 41 16 only). 

SR03 (Level 2): Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

SR10 (Level 2): Segment does not exist. 

SR11 (Level 2): Invalid old-segment-number (must range 
from 1 to 32767). 

SR20 (Level 2): A segment with that segment number 
already exists. 

SR21 (Level 2): Invalid new-segment-number (must range 
from 1 to 32767). 



REFERENCES 

BEGIN-NEW-SEGMENT command 
BEGIN-SEGMENT command 



new-segment-number 
as shipped — none 
on power-up — none 
if omitted — error SR21 
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Host Syntax 



E cKN \nV.view-number 



Setup Syntax 



RENEW s p view-number 



PARAMETERS 

view-number (-1 to 64). 

In the 41 14 and 41 16, this parameter has no effect. In the 
41 12, 41 13 and 41 15, it specifies the view to be renewed. 




1to64 



all views 

the current view 

a specific view 



DESCRIPTION 

On a 41 1 4 or 41 1 6, the RENEW-VIEW command erases the 
screen and redraws all visible segments. On a 41 1 2, 41 13, 
or 41 1 5, the RENEW-VIEW command erases the current 
view and redraws all segments visible in that view, plus the 
border and the framing box, if applicable. On all terminals, 
the dialog area is made visible again after the segments are 
redrawn (if it was visible before). 

The view-number parameter has no effect on 41 14 and 
41 16 terminals. 



4112, 4113, and 4115 View Number. On 4112, 41 13, and 
4115 terminals, if the view number is in the range from 1 to 
64, then that view (if it exists) is "renewed." That is, the 
viewport for that view is erased, and all the view's visible 
segments are redrawn. If the specified view does not exist, 
then a error KN10 occurs. 

Specifying view-number on these terminals causes the 
current view to be renewed. Specifying view number -1 
causes the terminal to erase the screen and then renew all 
views in sequence, ending with the current view. 



View Dispiay Ciusters. in the 41 12, 41 13, and 41 15 it is 
possible to group several views together in a "view display 
cluster." If this is done, then whenever a RENEW-VIEW 
command is issued for any view in the cluster, all views in 
the cluster are renewed. For details, see the description of 
the SET-VIEW-DISPLAYCLUSTER command. 



DEFAULTS 



view-number 

as shipped — none 
on power-up — none 
if omitted — 



ERRORS 



KN02 (Level 3): Out of memory while attempting to renew 
a view. (This error can also occur as a 
result of pressing the PAGE key. 41 1 2, 
4113, and 41 15 only.) 

KN10 (Level 2): The view specified does not exist. 

KN11 (Level 2): Parameter out of range (must range from 
-32768 to 32767). This parameter should 
be in the range from -1 to 64; however, 
the terminal will substitute -1 in place of a 
value which is less than -1 , and 64 in 
place of a value which is greater than 64. 



REFERENCES 

SELECT-VIEW command 
SET-SEGMENT-VISIBILITY command 
SET-VIEW-DISPLAY-CLUSTER command 
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REPORT-COLORHARDCOPY-STATUS Command option 09 

Host Syntax 




Setup Syntax 




DESCRIPTION REFERENCES 

The REPORT-COLOR-HARDCOPY-STATUS command Color-hardcopy-status-report message type 

causes the terminal to send a color-hardcopy-status-report 
to the host computer. 

ERRORS 

QQOO (Level 0): Unrecognized command (Option 9 not 
installed). 
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REPORT-DEVICE-STATUS Command 
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Host Syntax 



E cJQ dev\ce:device-specifier 



Setup Syntax 



E cJQ s p device-specifier 



PARAMETERS 

device-specifier 

Specifies the device whose status is to be reported to the 
host. Valid devices are: 



the host communication port 

the Option 42 and 43 disk drive devices 

— Z7: the Option 45 devices 

the Option 10 RS-232 peripheral ports 



the Option 9 screen pseudo device 
the Option 9 color hardcopy interface 

the Option 3A DMA interface 

the Option 3A pseudo devices 



HO 

F0 
F1 

SO 

P0 
P1 
P2 

SC 
HC 

DM 

DS 
SG 
PX: 
CM 



DESCRIPTION 

This command causes the terminal to send a device-status- 
report for the specified device to the host computer. The 
device may be the host communication port, a flexible disk 
drive, an Option 45 device, an RS-232 peripheral port, the 
color hardcopy interface and screen pseudo device, or the 
DMA interface and pseudo devices. 



if a valid but not installed device is specified as the string 
parameter, the terminal detects error JQ1 and returns as 
the status-integer in the device-status-report. 

If an invalid device code is specified as the string parameter, 
the terminal detects error JQ1 1 . Nevertheless, the terminal 
sends a device-status-report to the host computer with s p s p 
as the returned two-character device-mnemonic, and as 
the status-integer. 



DEFAULTS 

device-specifier 
as shipped — none 
on power-up — none 

if r^mittoH „ arrr\r IOl 1 



ERRORS 

JQ10 (Level 2) 
JQ1 1 (Level 2) 
JQ12 (Level 3) 



Device is not installed. 

Invalid device specifier. 

Out of memory while parsing parameter. 



REFERENCES 

Device-status-report message type 
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REPORT-ERRORS Command 
Host Syntax 




Setup Syntax 



E cKQ 



DESCRIPTION REFERENCES 

The REPORT-ERRORS command causes the terminal to Appendix C, "Error Codes" 

send an errors-report message to the host computer. In that Error-report message type 

message, the terminal reports the eight most-recently 
detected error codes, their severity levels, and how many 
times each error was detected. See the description of the 
error-report for details. 

The most recent error will be returned first, and the "signa- 
ture" characters used are those which have been specified 
for reports. 

When the terminal sends a report to the host, bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 
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REPORT-GIN-POINT Command 
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Host Syntax 



E clP \ntdevice-function-code 



Setup Syntax 



E clP s p device-function-code 



PARAMETERS 

device-function-code 

Valid values are -2, 0, 1 , 8, 9, 10, 24, 25, 32, 33, 40, and 
41 . See the ENABLE-GIN command for details on these 
numbers. 



DESCRIPTION 

The REPORT-GIN-POINT command forces the terminal to 
return to the host a GIN report for one "GIN event," without 
any operator interaction. This is a locator event, a pick 
event, or a stroke event, depending on the command's 
device-function-code parameter. 

li on\ i uuuci uai iuiiivj vi iiiiMiiy lociiduicu iui mat \*<vt*~< 

function-code, then the terminal performs the appropriate 
rubberbanding or inking function on its display. 

The position returned is the location in terminal space of the 
graphic cursor for the specified device-function-code. (How- 
ever, for device-function-code = -2, the position returned is 
the current graphic beam position.) 

When the terminal sends a report to the host, bypass mode 
is entered. (See enter-bypass-mode.) 



Device-Function-Code. The device-function-code specifies 
which graphic input device is to be used, and which graphic 
input function (locator, pick, or stroke) is to be used. This 
parameter is identical to the corresponding parameter in the 
ENABLE-GIN command; for details, seethe ENABLE-GIN 
command description. 
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minal to report the current graphic beam position. The for- 
mat for the report is the same as a locate report. 



Terminal Already Enabled for That Device and Function. 

If an ENABLE-GIN command has already enabled the 
terminal for the specified device-function-code, then the 
REPORT-GIN-POINT command serves only to force a "GIN 
event." The terminal behaves as if the operator had initiated 
the GIN event, except that the ASCII character returned as 
the "keypressed" part of the GIN report is always the s p 
character. 



Terminal Not Already Enabled for That GIN Device and 
Function. If the terminal was not already enabled for the 
specified GIN 

device-function-code, then the following occurs: 

1 . The terminal executes an implicit ENABLE-GIN com- 
mand for that device-function code and a "count" 
parameter of one. 

2. The terminal sends to the host the GIN-report- 
sequence for the implicit ENABLE-GIN it has just exe- 
cuted. In the report, the xy parameter shows the 
position in terminal space for the cursor currently 
assigned to the specified device-function combination. 
In the report, the "key pressed" ASCII-char parameter 
is the s p character. 

The graphic cursor "blinks" momentarily. (The graphic 
cursor turns on as the terminal executes the implicit 
ENABLE-GIN command. Then it turns off again as the GIN- 
report-sequence is sent to the host computer.) 
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DEFAULTS 



REFERENCES 



device-function-code 
as shipped — none 
on power-up — none 
if omitted — error IP1 1 



ERRORS 



1011 (Level 2): Invalid device-function code. (Seethe 
description of the ENABLE-GIN com- 
mand for a list of valid device-function 
codes.) 
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in the terminal. 

IE13 (Level 2): A plotter device is not specified for the 
specified port. 

IP1 3 (Level 2): The device-function code names a device 
which has already been enabled for a dif- 
ferent graphic input function. 



REPORT-4010-STATUS command 
ENABLE-GIN command 
GIN -report-sequence message type 
GIN-locator-report syntactic construct 
GIN-pick-report syntactic construct 
GIN -stroke-report syntactic construct 
SET-GIN-RUBBERBANDING command 
SET-GIN-INKING command 
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REPORT-PORT-STATUS Command 



OPTION 10 



Host Syntax 



E cPQ device. port 



Setup Syntax 




PARAMETERS 



DbFAULlS 



port 



Specifies the peripheral port whose status is to be 
reported. Valid devices are: 

P0 
P1 
P2 



port 

as shipped — none 
on power-up — none 
if omitted — error PQ1 1 



ERRORS 



DESCRIPTION 

When the REPORT-PORT-STATUS command is received as 
an escape sequence, the terminal sends a port-status- 
report for the specified RS-232 peripheral port to the host 
computer. When the command is invoked by the operator in 
Setup mode, the terminal displays status information about 
all ports on its screen. 

When the terminal sends a report to the host, bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 



Port. The string parameter specifies the RS-232 peripheral 
port for which the report is to be generated. Here, P0: 
means peripheral port zero, PI: means peripheral port one, 
and P2: means peripheral port two. 

If this parameter is invalid (neither P0:, P1:, nor P2:), then 
the terminal detects a type PQ1 1 error. Nevertheless, it still 
sends a port-status-report to the host computer. That report, 
however, is abbreviated; its port-ID-code consists of two 
"space" characters, and the port-information is omitted. 
For details, see the description of the port-status-report 
message type. 



PQ00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PQ1 1 (Level 2): Invalid port identifier (must be P0:, P1 : 
or P2:). 

PQ12 (Level 3): Out of memory while parsing the 
parameter. 

REFERENCES 

COPY command 

ENTER-BYPASS-MODE command 
Port-status-report message type 
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REPORT-SEGMENT-STATUS Command 



Host Syntax 



E cSQ \nX:segment-number 


char-array:status-codes 


Setup Syntax 


E cSQ s p segment-number 


status-codes 



PARAMETERS 



DESCRIPTION 



segment-number (-3 to 32767). 

The segment for which you want information. 

-3 all segments that match the current 

matching class 

-2 the default values for segments not yet 

defined 

-1 all segments 

the crosshair cursor 

1 to 32767 a specific segment 

status-codes 

An array telling which informaton is to be returned for the 
specified segment. Valid array characters are: 



A 


classes 


D 


detectability 


H 


highlighting mode 


I 


image transform parameters 


M 


writing mode 


P 


pivot point 


S 


display priority 


V 


visibility 


X 


position 



The REPORT-SEGMENT-STATUS command causes the ter- 
minal to send a segment-status-report to the host computer. 

When the terminal sends a report to the host, it enters 
bypass mode. (See ENTER-BYPASS-MODE.) 



Segment Number. The first parameter in the REPORT- 
SEGMENT-STATUS command specifies the segment num- 
ber. If this is a number in the range from 1 to 32767, then the 
segment-status-report includes information about that one 
specified segment. If this parameter is 0, then the segment- 
status-report reports information (position, visibility, etc.) 
about the crosshair graphics cursor. If the parameter is -1 , 
then the segment-status-report includes information about 
all segments in the terminal's memory. If the parameter is 
-2, the report contains information about the default for 
segments not yet defined. If this parameter is -3, then the 
report contains information about those segments that 
match the current matching class. 



Segment Information Codes. The second parameter in the 
REPORT-SEGMENT-STATUS command specifies which 
information about the segment (or segments) is to be 
reported. Each type of information is represented by an 
uppercase letter in this char-array, as listed under the 
PARAMETERS section of this command description. If the 
char-array is empty (has a count of zero), then the only infor- 
mation in the segment-status-report will be the segment 
number(s). 

For information about the format of reports which the termi- 
nal sends to the host in response to this command, see the 
description of the segment-status-report. 
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DEFAULTS 



REFERENCES 



segment-number 
as shipped — none 
on power-up — none 
if omitted — 

status-codes 

as shipped — none 
on power-up — none 
if omitted — empty array 



Array parameter types 
Segment-status-report syntactic construct 
SET-SEGMENT-CLASS command 
SET-SEGMENT-DETECTABILITY command 
SET-SEGMENT-HIGHLIGHTING command 
SET-SEGMENT-IMAGE-TRANSFORM command 
SET-SEGMENT-POSITION command 
SET-SEGMENT-VISIBILITY command 
SET-SEGMENT-WRITING-MODE command 



ERRORS 

SQ10 (Level 2): Segment does not exist. 

SQ1 1 (Level 2): Invalid segment-number (must range 

SQ21 (Level 2): Invalid array of codes. (Must include only 
the uppercase letters A, D, H, I, M, R S, V, 
and X. Also, the array count must be in 
the range from to 65535.) 

SQ22 (Level 3): Out of memory while parsing the 
parameter. 
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REPORT-TERMINAL-SETTINGS Command 



Host Syntax 



E clQ inquiry-code inquiry-code = char char 



Setup Syntax 



STATUS s p e c inquiry-code inquiry-code = char char 



PARAMETERS 

inquiry-code 

A two-char parameter containing the two-letter op code 
for an escape-sequence command or a special two-char- 
acter inquiry code for other information about the 
terminal. 



DESCRIPTION 

This "general-purpose inquiry" command tells the terminal 
to send a terminal-settings-report to the host computer. 

When the terminal sends a report to the host, it enters 
bypass mode. (See the description of the ENTER-BYPASS- 
MODE command.) 



Char Parameters. The two-char parameter comprises either 
an op code for one of the terminal's commands or a special 
inquiry code. 

For instance, to inquire the terminal's current baud rate set- 
tings, one would issue a REPORT-TERMINAL-SETTINGS 
command in which the two char parameters are NR. (This is 
because the SET-BAUD-RATES command has the op code 
NR.) 

REPORT-TERMINAL-SETTINGS : baud rates 
= REPORT-TERMINAL-SETTINGS : NR 
= E clQNR 

In response, the terminal sends a terminal-settings-report to 
the host computer, in which it reports the current values of 
the parameters for the command whose op code was given 
in the REPORT-TERMINAL-SETTINGS command. 



For example, the terminal-settings-report sent in response 
to a REPORT-TERMINAL-SETTINGS : NR command would 
report the terminal's current transmit and receive baud 
rates. 

Besides the op codes for commands, several special inquiry 
codes may be given in the REPORT-TERMINAL-SETTINGS 
command. These codes are listed in Table 7-1 7. 

If you specify a numerical inquiry-code, 01 to 99, the termi- 
nal returns the firmware version number for optional firm- 
ware. (If the option is not installed, the terminal returns a 
zero for the firmware version number.) 
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21 
22 
23 



42 
45 
99 



Table 7-17 
SPECIAL INQUIRY CODES 



Code 


Meaning 


?M 


Inquires how much free memory is available. 


?T 


Inquires the terminal model. 


00 


Inquires the firmware version number for the standard 
terminal. 


01 


Option 1 (Extended Communications) 


03 


Option 3A (41 15 DMA Interface) 


04 


Options 4A, 4C, 4E, 4F, and 4K (Optional keyboards) 


09 


Option 09 (41 1 3 and 41 1 5 Color Hardcopy Interface) 


10 


Option 10 (Three Port Peripheral Interface) 


13 


Option 1 3 or 1 4 (Graphic Tablet) 


20 


41 1 2 ODtion 20 — returns 1 " if the option is (if the 



terminal is equipped with 3 bit planes), and 0" is the 
option is not installed (if the terminal has only one bit 
plane). 



41 13 Option 21 — returns 1" if the option is installed 
(if the terminal has 4 bit planes), otherwise returns 0". 



41 1 5 Option 22 — returns 1 " if the option is installed 
(if the terminal has 6 bit planes), otherwise returns 0". 



REFERENCES 

Int-report parameter type 
Real-report parameter type 
SET-REPORT-SIG-CHARS command 
Terminal-settings-report message type 
XY-report parameter type 



4115 Option 23 — returns 1 " if the option is installed 
(if the terminal has 8 bit planes), otherwise returns 0" 



Option 42 or 43 (Disk Drive) 



Option 45 (Mass Storage Interface Board) 



Returns terminal part number suffix information. 
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REPORT-4010-STATUS Command 
Host Syntax 




DESCRIPTION REFERENCES 

The REPORT-401 0-STATUS command causes the terminal 4010-status-report message type 

to emulate a TEKTRONIX 4010 Series terminal and send to ENTER-BYPASS-MODE command 

the host a 4010-status-report. 

The 4010-status-report may take two alternate forms, 
depending on whether or not the terminal is emulating 4010 
GIN mode. (The terminal is emulating 4010 GIN mode if it 
has received an ENABLE-4010-GIN command, but the 
operator has not yet pressed a key to initiate a 4010-GIN- 
report.) See the description of the 4010-status-report for 
details. 

In the 4010-status-report, a 4010-xy-report is included. This 
4010-xy-report includes the most significant ten bits of the 
X-coordinate and the most significant ten bits of the Y-coor- 
dinate of some point in terminal space. Since the least sig- 
nificant two bits of the X- and Y- coordinates are omitted, the 
point in terminal space to which this 4010-xy-report refers 
cannot be determined precisely; there may be an error of up 
to three terminal space units. 

The e c e q command terminates 4010-Style-GIN and returns 
the terminal to Alpha mode. 

When the terminal sends a report to the host, it enters 
bypass mode (see ENTER-BYPASS-MODE). 
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RESET Command 



Host Syntax 




Setup Syntax 




UbSCHiK i iON 

The RESET command initializes the terminal to its power- 
up condition. It is equivalent to pressing the MASTER 
RESET key, or to turning the terminal off and then turning it 
on again. 



NOTE 

The terminal takes at least 15 seconds to execute the 
RESET command; the 41 15 terminal takes more 
time. During that time, it is performing its power- 
up reset and self -test routines, and cannot process 
data coming from the host. 

Therefore, if you issue a RESET command from 
the host, you should wait at least 15 seconds before 
sending other commands or data to the terminal; 
allow 30 seconds for a 41 15 terminal. 
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RESTORE Key 



4112,4113,4115 



DESCRIPTION 

The RESTORE key exists only on 41 1 2, 41 1 3, and 41 1 5 ter- 
minals. It does not auto-repeat. 

The RESTORE key (the SHIFTed version of the VIEW key) 
lets the operator access the terminal's "memory" of win- 
dows — and framing boxes — previously used for the cur- 
rent view. Pressing this key restores current view's window 
and framing box to the size, shape, and position they had 
when the OVERVIEW or VIEW key was last pressed. (If the 

L^ntiiilwil iO IIUl II t IIUHig ii IWUk> UlUi Id, it HCiUiCI Li 1C k_WWi¥i 

light nor the PAN light is on — then the "restored" framing 
box will not be visible.) 

If the current view is part of a view display cluster, then the 
RESTORE key affects all views in that display cluster. (See 
the description of the SET-VIEW-CLUSTER command for 
details.) 



These "old values" for the window and framing box are pre- 
served on a stack whose depth never exceeds three. Since 
there are no more than three "old" sets of values stored on 
the stack, you can always get "back to where you were" by 
pressing the RESTORE key no more than four times. 

The 41 1 5 retains the last three views and the overview. 
Repeated pressing of this key cycles through the four 
retained views. 

If the CTRL key is pressed together with RESTORE, then 
the original window and framin n box ar<? restored. This Is 
the window that was created by the latest SET-WINDOW 
command, and the framing box that existed when the 
ZOOM or PAN mode was first entered for this view. 

Window and framing box values are entered into the stack 
each time that the OVERVIEW or VIEW key changes a 
view's window. 



Only the window and framing box are restored. The 
RESTORE key will not replace segments which may have 
been deleted or made invisible; nor will it change to other 
numbered views. 

Pressing the RESTORE key again restores the window and 
framing box to their conditions at a yet earlier time: the 
"next to last time" that the OVERVIEW or VIEW key was 
pressed. 



REFERENCES 

OVERVIEW key 
PAN key 

SET-VIEW-CLUSTER command 
SET-WINDOW command 
VIEW key 
ZOOM key. 
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RUNLENGTH-WRITE Command 



4112,4113,4115 



Host Syntax 



E cRL mi-array.runcode-array 



Setup Syntax 



E cRL s p runcode-array 



PAhAME i tuS 

runcode-array 

The runcodes in the runcode-array can range from to 
65535 for a 41 1 2, 41 1 3, 41 1 4, or 41 1 6; 41 1 5 runcodes 
can be from to 2 31 -1 . Each runcode includes two num- 
bers packed together: a color index and the number of 
pixels which are to be set to that color index. 



DESCRIPTION 

The RUNLENGTH-WRITE command is one of two com- 
mands by which color indices may be loaded into a fill pat- 
tern which is being defined or into the pixel viewport. (The 
other command is the RASTER-WRITE command.) 



Runcode-Array. The runcode-array parameter contains a 
number of runcodes. Each runcode is an integer into which 
are packed two numbers: 

• A color index to which a series of pixels (a "run" of 
pixels) are to be set. 

• The number of pixels in that run. 

The packing scheme is as follows: 

runcode = (number-of-pixels) ■ 2 N + (color-index) 
where 

N = number-of-bits-per-pixe! 
and where 

2 N = two-raised-to-the-power-N 



if *h e RUNLENGTH-WRITE command is part of a Jill-pat- 
tern-definition, then the packing formula uses the bits-per- 
pixel parameter from the BEGIN-FILL-PATTERN command 
that began that fill-pattern-defmition. Otherwise, the bits- 
per-pixel parameter from the most recent BEGIN-PIXEL- 
OPERATIONS command is used. 

However, there is an exception to this: if the BEGIN-PIXEL- 
OPERATIONS or BEGIN-FILL-PATTERN command speci- 
fied six bits per pixel, the bits-per-pixel value in the packing 
scheme is three (for the 41 1 2) or four (for the 41 1 3). The 
41 1 5 uses six bits-per-pixel. 

If number-of-pixels is 0, then no color indices are loaded 
and the pixel beam position does not change. 



41 1 2, 4113. Starting at the top left of the fill pattern rectan- 
gle or the current pixel beam position in the pixel viewport, 
the color index for each runcode is loaded into L pixels, 
where L is the length of the run for that runcode. As each 
pixel receives a color index, the pattern position or pixel 
beam position moves, so that it points at the next pixel to 
the right on the same line. On encountering the right edge 
of the fill pattern rectangle or pixel viewport, the pattern 
position or pixel beam position "wraps around" to point to 
the leftmost pixel on the line below. When all the pixels for a 
given run have been loaded with the color index for that run, 
the process is repeated for the next runcode in the int-array. 
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4115. The 4115 behaves like a 41 1 2 or 41 1 3 when fill pat- 
terns are being defined. However, for each pixel that is to be 
displayed on a 41 15, the parameters of the SET-PIXEL- 
WRITING-FACTORS command determine the area (in pix- 
els) covered by each color index, and the direction in which 
the beam position moves. If you do not enter the SET- 
PIXEL-WRITING-FACTORS command, the 41 15 terminal 
behaves like a 41 1 2 or 41 1 3. 



Too Many Color Indices. If more color indices are sent in 
the code-array than it takes to fill the fill pattern, that fill-pat- 
tern-definition is ended. There is no need, in this case, for 
an END-FILL-PATTERN command. Excess color indices 
within the same RUNLENGTH-WRITE command are 
ignored. 

If the RUNLENGTH-WRITE command is sending color indi- 
ces to the current pixel viewport, the pixel beam position 
"wraps around" from the last pixel in the bottom row of the 
pixel viewport to the first pixel in the top row of that view- 
port, and the pixel loading continues. 



ERRORS 

RLOO (Level 2): Unrecognized command. (The terminal is 
not a 41 12, 4113, or 41 15.) 

RL11 (Level 2): Invalid runcode-array. { The array count 
must range from to 65535. The ints 
must be: 41 1 2, 41 1 3: to 65535; 
4115:0to2 31 -1.) 

RL12 (Level 3): Out of memory while parsing the 
parameter. 

REFERENCES 

BEGIN-FILL-PATTERN command 
BEGIN-PIXEL-OPERATIONS command 
RASTER-WRITE command 
SET-PIXEL-WRITING-FACTORS command 



DEFAULTS 

runcode-array 

as shipped — none 
on power-up — none 
if omitted — empty array 
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SAVE Command 



Host Syntax 



E cJV str\ng:thing-to-be-saved 


mt.item-number-or-count 


s\x\nq:separator 


dev\ce:destination 


Setup Syntax 


SAVE s p thing-to-be-saved item-number-or-count 


TO 


destination 





PARAMETERS 

thing-to-be-saved 

The thing that you want to save. You can save macro def- 
initions, segment definitions, raster definitions, and 
runiength definitions. Valid specifiers are: 

MAC macro definition 

SEG segment definition 

RAS the pixel viewport contents with RASTER- 

WRITE commands 

RUN the pixel viewport contents with 

RUNLENGTH-WRITE commands 

item-number-or-count (-4 to 32767). 

The number (as in segment-number) or count (as in 
number-or-pixels) of the thing you want to save, 

separator 

The empty string or TO. 

destination 

The device and/or file where you want what you are sav- 
ing saved. Valid specifiers are: 

HO: the host computer 

FO:filename files on Disk Drive FO: 
filename 

F1 filename files on Disk Drive F1 : 

SO:filename — files on Option 45 devices 
Z7:filename 



PO: 
P1: 
P2: 

DM: 



Option 10; the Three Port Peripheral 
Interface 



the Option 3A DMA interface 



DESCRIPTION 

The SAVE command causes the terminal to save an item 
from its internal memory by sending a series of escape- 
sequence commands to the specified destination. The 
"item" may be: 

• A macro definition. 

• A segment definition. 

• On the 41 12, 4113, and 41 15 only, a series of pixels from 
the current pixel viewport. 

The item is saved by sending a series of escape-sequence 
commands to the specified destination. That destination is 
typically a file on the terminal's disk drive; by loading the 
file, the item saved can be created again in the terminal's 
internal memory. 



First Parameter. The save command's first parameter is a 
string of three letters. This must be: 

string : "MAC" = 3MAC to save a macro definition. 

string : "SEG" = 3SEG to save a segment definition. 



string : "RAS" = 3RAS 



string : "RUN" = 3RUN 



to save pixels from the 41 1 2, 
4113, or 41 1 5 pixel viewport 
using RASTER-WRITE com- 
mands. 

to save pixels from the 41 1 2, 
411 3, or 41 1 5 pixel viewport 
using RUNLENGTH-WRITE 
commands. 
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Second Parameter. The second parameter is of the int 
parameter type, representing an integer number. 

• If a macro definition is being saved, this int is the macro 
number. Valid macro numbers are -1 and 1 to 32767. 
Macro number -1 means "all macro definitions." 

• If a segment is being saved, this int is the segment num- 
ber. This must be in the range from -4 to -1 and from 1 to 
32767. Positive segment numbers represent specific 
user-defined segments; an error is detected if the speci- 
fied segment has not been defined. Segment number -1 
means "all user-defined segments," and segment num- 
ber -3 means "all segments that match the current seg- 
ment matching class." Specifying segment -2 causes 
the terminal to save the default segment attributes for 
segments which have not yet been defined. Segment -4 
means "all segments visible in the current view" and 
causes an action equivalent to the PLOT command. 

• If pixels from the 41 1 2, 41 1 3, or 41 1 5 pixel viewport are 
being saved, this int specifies the number of pixels to be 
saved, starting at the current pixel beam position. The 
pixel beam position is updated after the SAVE command 
has been executed to the position following the last pixel 
saved. 

Specifying -1 for this parameter causes the entire pixel 
viewport to be saved. In this case, the pixel beam posi- 
tion is not changed. 

Specifying -2 for this parameter causes the number of 
bits-per-pixel, the pixel viewport dimensions, the pixel 
factors (as set by the SET-PIXEL-WRITING-FACTORS 
command) and the entire pixel viewport to be saved. The 
pixel beam position is then restored to the position it had 
before the SAVE command. Specifying -2 provides all 
the information necessary to reconstruct the pixel image 
except the surface and color map settings. 

• On a 41 15, the Coordinate mode is initially set to 
(smaller range) until an X- or Y-coordinate greater than 
4095 must be saved. At this point, a SET-COORDINATE- 
MODE command is issued to change the Coordinate 
mode to 1 . 



Third Parameter. The third parameter is a separator string; 
this must be either the empty string (count of zero) or the 
string 2TO. 



Fourth Parameter. The fourth parameter is a string specify- 
ing the destination for the escape-sequence commands 
which are being saved. 



Contents of Files Created by the SAVE Command. The 

SAVE command saves the specified information as a series 
of escape-sequence commands for the terminal. When 
those commands are executed, the item saved is recreated 
in the terminal's internal memory. 

When a macro definition is saved, a DEFINE-MACRO com- 
mand is sent to the destination device specified in the save 
command. 

When a segment definition is saved, the following com- 
mands are sent to the destination device specified in the 
save command: 

• For segment -4 (on 4112,4113, and 4115 terminals) 
WINDOW and VIEWPORT commands, specifying the 
window and viewport. 

• A series of commands to set default segment attributes 
for segments not yet defined: SET-SEGMENT-HIGH- 
LIGHTING, SET-PIVOT-POINT, SET-SEGMENT-IMAGE- 
TRANSFORM, etc. 

• ASET-GRAPHTEXT-PRECISION: 1 command, setting 
the graphtext precision to "string precision." 

• A BEGIN-SEGMENT command for the segment speci- 
fied in the save command's second parameter. 

• A series of graphic primitives, and commands to set 
primitive attributes. These might include ENTER-VEC- 
TOR-MODE commands, xy coordinates, MOVE, DRAW, 
DRAW-MARKER commands, SET-LINE-STYLE com- 
mands, etc. 

• An END-SEGMENT command to terminate the segment 
definition. 

Also, be aware that: 

• Alphatext is saved as string-precision graphtext. 

• When a segment is subsequently loaded, it may change 
some of the command settings which were in effect 
before the segment was loaded. To see the commands 
which are stored in the file created by a save command, 
put the terminal in snoopy mode and load the file. 

• Ona4112,4113, and 41 1 5, a segment's visibility attrib- 
ute is not saved by the SAVE command. Consequently, a 
set of segments can be saved with a -1 or -3 int parame- 
ter, then loaded with the LOAD command, and the 
screen may look different, since all segments will be 
either visible or invisible. 

• When thing-to-be-saved is RAS or RUN, BEGIN-PIXEL- 
OPERATIONS and SET-PIXEL-VIEWPORT commands 
are saved, to allow the minimum information necessary 
to reconstruct the pixel image. 
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• On a 41 15, when thing-to-be-saved is RAS or RUN, and 
item-number-or-count is -2, SET-PIXEL-WRITING- 
FACTORS, BEGIN-PIXEL-OPERATIONS and SET- 
PIXEL-VIEWPORT commands are saved, to allow the 
minimum information necessary to reconstruct the pixel 
image. 

NOTE 

When the file created with a save command is later 
used to load a segment definition back into the 
terminal, the commands in that file will change 
the default segment attributes for segments not 
yet defined. (This is because of the commands 
in the file which set the segment attributes for 
"segment - 2.") 

When pixeis from the 4112, 4113, or 41 1 5 pixel viewport are 
saved, one or more RASTER-WRITE or RUN-LENGTH 
commands are sent to the destination specified in the SAVE 
command. 



DEFAULTS 

thing-to-be-saved 
as shipped — none 
on power-up — none 
if omitted — error JV1 1 

item-number-or-count 
as shipped — none 
on power-up — none 
if omitted — error JV21 



ERRORS 

JV02 (Level 3): Out of memory while attempting DMA 
transfer (Option 3A only). 

JV1 1 (Level 2): Invalid thing-to-be-saved. (Must be MAC, 
SEG, RAS, or RUN. The latter two codes 
are valid for 41 1 2, 41 1 3, and 41 1 5 termi- 
nals only.) 

JV12 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 



JV21 
JV31 



/I ....I «-*\. 
(LCVCI £.). 



(Level 2): 
(Level 2): 



JV32 (Level 3): 



exist, or segment is being defined. 

Invalid item-number-or-count. 

Invalid separator (must be empty string 
or TO). 

Out of memory whiie parsing the 
parameter. 



JV40 (Level 2): The specified destination is not installed. 

JV41 (Level 2): Invalid destination specifier. 

JV42 (Level 2): Out of memory while parsing the parame- 
ter, or while executing the command. 

JV43 (Level 2): Not a valid destination device, device is 

busy, or existing disk file is write protected 
or open. 

JV49 (Level 2): Device hardware error. (I/O error, drive not 
ready, hardware write-protect error, or 
DMA block transfer error.) 

REFERENCES 



separator 

as shipped — none 
on power-up — none 
if omitted — error JV31 

destination 

as shipped — none 
on power-up — none 
if omitted — error JV41 



COPY command 

EOF-string syntactic construct 

LOAD command 

PLOT command 

SET-COORDINATE-MODE command 

SET-CURRENT-MATCHING-CLASS command 

SET-PIXEL-WRITING-FACTORS command 
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Segment-Status-Report Message Type 



SYNTAX 



segment-status-report = 



report-for-one-segment = 



segment-attribute-report = 



[report-for-one-segment. . .] 

[term-sig-char] 

EOM-indicator 

[EOM-indicator] 

[sig-char] 

\n\.-report:segment-number-or-error-code 

[segment-attribute-report. ..] 

[EOM-indicator] 



r segment-class-report 
detectability-report 
highlighting-report 
image-transform-report 

^ writing-mode-report \ 
pivot-poin t-report 
display-priority-report 
visibility-report 
position-report 



segment-class-report = char-report:A 

int-array-report:c/csi'-«M/wfcer5 



detectability-report = 
highlighting-report = 
image-transform-report 



char-report:D 
int-report:0 or 1 

char-report:H 
int-report:0 or 1 

= char-report: I 

real-report:x-sca/e-/acfor 
real-report:.y-sca/e-/acfor 
rea\-report:rotation-in-degrees 
xy-report:position 



writing-mode-report = char-reporf.M 

int-report:1 or 2 

pivot-point-report = char-report:P 

xy-report:pivot-point 

display-priority-report = char-report:S 

m\-repori:display-priority 

visibility-report = char-report:V 
int-report:0 or 1 

position-report = char-report:X 

xy-reportposition 
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DESCRIPTION 

The terminal sends a segment-status-report to the host com- 
puter in response to the REPORT-SEGMENT-STATUS com- 
mand. When the terminal sends a report to the host, it 
enters bypass mode. (See ENTER-BYPASS-MODE.) 



Overall Syntax The segment-status-report consists of zero 
or more report-for-one-segments, followed by a term- 
sig-char and an EOM-indicator. 

Term-Sig-Char The term-sig-char is determined by the most 
recent SET-REPORT-SIG-CHARS command for non-GIN 
reports. (See the description of the SET-REPORT-SIG- 
CHARS command for details.) The term-sig-char is provided 
as a convenience for the host routine which parses the 
segment-status-report, it serves to mark the en«j Oi *■ ie 
report. 

If the term-sig-char is N u, it is omitted from the segment-sta- 
tus-report. However, setting the term-sig-char to N u would be 
unwise; the host applications program probably needs the 
term-sig-char to tell when it is done parsing the segment-sta- 
tus-report. 



Final EOM-lndicator After sending the term-sig-char, the 
terminal ends the segment-status-report with an EOM-indi- 
cator. This EOM-indicator is always sent; it helps to ensure 
that the host applications program receives the preceding 
characters in a timely manner. (In most host operating sys- 
tems, the user program does not actually receive a mes- 
sage from the terminal until the message ends with a c r.) 

Report-for-One-Segment Each repori-for-one-segment 
describes the attributes for one segment. 

The report-for-one-segment may begin with an optional 
EOM-indicator. This EOM-indicator is provided because of 
the terminal's "maximum line length" feature. (See the 
description of the SET-REPORT-MAX-LINE-LENGTH com- 
mand for details.) If too many characters have already been 
sent on the current line, so that sending the remainder of 
the report-for-one-segment would cause the maximum line 
length to be exceeded, then the terminal ends the current 
line with an EOM-indicator. The sig-char that follows would 
then be the first character of the next line of text. 



This EOM-indicator is sent only if the following conditions 
are met: 

• At least one character has already been sent on this line. 
(That is, at least one character has already been sent 
since the last EOM-indicator.) 

• Were this line not to be terminated now (by sending the 
EOM-indicator), then this report-for-one-segment would 
cause the maximum line length to be exceeded. 

• The most recent SET-REPORT-EOM-FREQUENCY 
command specified "more frequently" rather than "less 
frequently." 

The sig-char is provided as a convenience for the host pro- 
gram's parsing routine. It serves to mark the beginning of 
each report-for-one-segment. The sig-char is a single ASCII 
character, determined by the most recent SET-REPORT- 
SIG-CHARS command for non-GIN reports. (See the SET- 
REPORT-SIG-CHARS command for details.) If the sig-char 
is N u, it is omitted. 

After the sig-char comes an int-report: the segment number 
(or error code) for the particular segment whose attributes 
are being reported. If the char-array parameter in the 
REPORT-SEGMENT-STATUS command was empty, then 
the segment number is the only item reported in the report- 
for-one-segment. An error code (described later) is substi- 
tuted for the segment number if an invalid segment number 
or segment attribute code, or if the segment specified does 
not exist. 

Following the segment number, each report-for-one-seg- 
ment contains zero or more segment-attribute-reports. 
There is one segment-attribute-report for each letter in the 
char-array parameter of the REPORT-SEGMENT-STATUS 
command. 

Each segment-attribute-report contains information about 
one of the segment's attributes, and begins with the code 
letter for that attribute. For instance, a segment-classes- 
report begins with the letter A, visibility-report begins with 
the letter V, and a position-report begins with the letter X. 

The pivot-point-report portion of the segment-attribute- 
report is invalid if the segment was created using the SG: 
pseudo device of the DMA (Option 3A) interface. 
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ERRORS 

If the REPORT-SEGMENT-STATUS command specified an 
invalid segment number, a segment number for a segment 
which does not exist, or an invalid code letter for a segment 
attribute, then the segment-status-report sent back to the 
host includes an error code. In that case, the report-for- 
one-segment has the special error code integer in place of 
the segment number, and there are no segment-attribute- 
reports. Table 7-1 8 lists these special error codes. 



Table 7-18 
ERROR CODES IN SEGMENT-STATUS-REPORTS 



segment-number 
Error Code 


Meaning 


-32767 


The segment number in the 
REPORT-SEGMENT-STATUS was invalid. 


-32766 


The REPORT-SEGMENTSTATUS 
command specified a segment number for a 
segment which does not exist 


-32765 


The REPORT-SEGMENTSTATUS 
command included (in its char-array) a letter 
which is not a valid segment attribute code. 



In addition to the error information in the segment-status- 
report, type SQ10, SQ1 1 , and SQ21 errors are detected in 
the terminal. These error codes will be sent to the host if a 
REPORT-ERRORS command is issued. (For details, see 
the descriptions of the REPORT-ERRORS command and 
the errors-report syntactic construct.) 

REFERENCES 

Char-report parameter type 
Int-report parameter type 
REPORT-ERRORS command 
REPORT-SEGMENT-STATUS command 
SET-REPORT-SIG-CHARS command 
X Y-report parameter type 
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SELECT-ALPHATEXT-SIZE-GROUP Command 



4114,4116 



Host Syntax 



E cMY \r\tgroup 



Setup Syntax 



ASIZEGROUP s p group 



KAfiAMt I ERS 



DEFAULTS 



group (0 or 1). 

Selects between 4014 alphatext size group and 401 6 
alphatext size group. 

4014 alphatext size group 

1 401 6 alphatext size group 



group 

as shipped — 

on power-up — remembered 

if omitted — 



ERRORS 



DESCRIPTION 

The SELECT-ALPHATEXT-SIZE-GROUP command modi- 
fies the effect of the SET-401 4-ALPHATEXT-SIZE command 
so that both 401 4 and 401 6 character sizes can be 
emulated. 

Table 7-1 9 summarizes how alphatext sizes change when 
different alphatext size groups are assigned. 



MY00 (Level 0): Invalid command (terminal is not a 41 14 
or 41 16). 

MY1 1 (Level 2): Invalid group (must be either or 1). 



REFERENCES 

SET-ALPHATEXT-SIZE command 
SET-401 4-ALPHATEXT-SIZE command 



Table 7-1 9 
PRE-DEFINED TEXT SIZES 



SET- 

ALPHATEXT- 
SIZE-GROUP 
bit 


SET-401 4- 
ALPHATEXT- 
SIZE setting 


SET- 
ALPHATEXT- 
SIZE ints 


Chars. 

per 

Line 


Lines 

per 

Page 


0or1 


E c8 


10,6,28 


74 


35 


0or1 


E c9 


9, 6, 28 


81 


38 





E c: 


6,4, 17 


121 


58 


1 


E c: 


5,6,18 


133 


64 





E c; 


5,6,18 


133 


64 


1 


E c; 


4,3,12 


179 


76 
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Section 7 (cont) Page 

SELECT-CODE Command 7-191 

SELECT-FILL-PATTERN Command 7-192 

SELECT-HARDCOPY-INTERFACE Command 7-195 

SELECT-VIEW Command 7-196 

SET-ALPHATEXT-FONT Command 7-198 

SET-ALPHATEXT-SIZE Command 7-199 

SET-BACKGROUND-COLOR Command 7-201 

SET-BACKGROUND-GRAY-LEVEL Command 7-203 

SET-BACKGROUND-INDICES Command 7-204 

SET-BAUD-RATES Command 7-206 

SET-BLOCK-CONTINUE-CHARS Command 7-208 

SET-BLOCK-END-CHARS Command 7-209 

SET-BLOCK-HEADERS Command 7-210 

SET-BLOCK-LENGTH Command 7-212 

SET-BLOCK-LINE-LENGTH Command 7-213 

SET-BLOCK-MASTER-CHARS Command 7-214 

SET-BLOCK-NON-XMT-CHARS Command 7-215 
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SELECT-CODE Command 



Host Syntax 




Setup Syntax 




PARAMETERS 

command-set (0 or 1 ). 

Specifies which command set is valid for the terminal. 
Setup mode parameters are TEK and ANSI. 



TEK command set 
ANSI X3.64 command set 



DEFAULTS 

command-set 
as shipped — 
on power-up — 
if omitted — 

ERRORS 



DESCRIPTION 

This command causes the terminal to recognize the com- 
mands of either the ANSI X3.64 or the TEKTRONIX 41 00 
System, depending on the selected parameter. Since the 
syntax of the two command sets are different and overlap- 
ping, the terminal recognizes oniy one command set at a 
time. 

Setup mode has a separate command parser, and is 
therefore not affected by this command. 

When TEK mode is selected, this command puts the 
terminal into Alpha mode. 



°/o!00 (Level 0): Unrecognized command; terminal 
firmware is Version 3. 

°/o! 1 1 (Level 2): Invalid command-set (must be or 1 .) 



REFERENCES 

ENTER-ALPHA-MODE command 
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SELECT-FILL-PATTERN Command 



4112,4113,4115 



Host Syntax 



E cMP 'mtfill-pattern-number 



Setup Syntax 




PARAMETERS 



DESCRIPTION 



fill-pattern-number (-32768 to 32767). 

Numbers from 1 to 32767 represent specific fill patterns. 
Of these, patterns 1 to 16 are predefined, while patterns 
1 7 through 32767 exist only if defined by the user. Zero 
and negative numbers represent fill patterns which 
consist entirely of the corresponding color index. In the 
41 12, numbers from -32768 to -8 cause panels not to be 
filled. In the 41 13, numbers from -32767 to -16 cause 
panels not to be filled. In the 41 15, numbers from -32767 
to -256 cause panels not to be filled. 



This command selects the pattern used to fill the interior of 
panels. The pattern number can range from -32768 to 
32767, as follows: 

• In the 41 12, fill patterns -7 to fill with the corresponding 
(positive number) color index. All other negative num- 
bers cause the interiors of subsequent panels to be left 
unfilled. In the 41 1 3, fill patterns -1 5 to fill panels with 
solid color indices. In the 41 15, fill patterns -255 to fill 
panels with solid color indices. 

• Patterns 1 through 16 are pre-defined; Figure 7-1 1 
shows examples of these fill patterns. Patterns 1 through 
1 6 may be redefined by the user; but if these patterns are 
deleted (redefined with a height of zero), they will not 
revert back to the predefined patterns until the terminal 
is turned off or reset. 

• Patterns 1 7 through 32767 are reserved for the user to 
define. 
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Figure 7-1 1 . Standard Fill Patterns. 
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In the 41 1 2, the default is pattern number -7, in the 41 1 3 
and 41 15 the default pattern is -16, and for the 41 15, the 
default pattern is -255. 

If a panel being filled occurs on a surface which has fewer 
bit planes than the bits-per-pixel value used to define the fill 
pattern, then the terminal uses only the high-order bits of 
each color index in the fill pattern. (This is the same rule as 
that employed by RASTER-WRITE, RUNLENGTH-WRITE, 
and PIXEL-COPY commands.) 

Table 7-20 lists the number of bits-per-pixel used for each 
positive numbered predefined fill pattern. 



Table 7-20 

NUMBER OF BITS-PER-PIXEL 
IN PREDEFINED FILL PATTERNS 



Fill Pattern Numbers 


Bits-Per-Pixel 


Oand 1 


1 


2 and 3 


2 


4to7 


3 


8 to 15 


4 


16to31 


5 


32 to 63 


6 


64 to 127 


7 


128 to 255 


8 



DEFAULTS 

fill-pattern-number 

as shipped — 41 1 2: -7; 41 1 3, 41 1 5: -1 
on power-up — 41 1 2: -7; 41 1 3, 41 1 5: -1 
if omitted — 



ERRORS 

MP00 (Level 2): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

MP10 (Level 2): Specified fill pattern does not exist (has 
not been defined). 

MP1 1 (Level 2): Invalid fill pattern number (must range 
from -32768 to 32767.) 



REFERENCES 

BEGIN-FILL-PATTERN command 
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SELECT-HARDCOPY-INTERFACE Command 



OPTION 09 



Host Syntax 



E cQD mV.interface 



Setup Syntax 




PARAMETERS 



DEFAULTS 



interface (0 or 1). 

Specifies which hardcopy interface is used when the 
termina! receives a hardcopy command. Setup mode 
parameters are MONO and COLOR. 

MONO: the standard hardcopy interface, to 
which can be connected TEKTRONIX 461 2 
and 4632 Video Hard Copy Units. 

1 COLOR: the Option 9 hardcopy interface, 
to which can be connected a TEKTRONIX 
4691 Color Graphics Copier. 

DESCRIPTION 

The SELECT-HARDCOPY-INTERFACE command selects 
the hardcopy interface that is used when the terminal 
receives a HARDCOPY command or a 4010-HARDCOPY 
command, or when the HARD COPY key is pressed. This 
command chooses between the standard hardcopy inter- 
face and the Option 9 color hardcopy interface. This com- 
mand is recognized only by a 41 1 3 or 41 1 5 terminal with 
Option 9 installed. 



interface 

as shipped — 

on power-up — remembered 

if omitted — 



ERRORS 



QD00 (Level 0): Unrecognized command (Option 9 is not 
installed). 

QD1 1 (Level 2): Invalid interface parameter (0 and 1 are 
valid). 



REFERENCES 

HARDCOPY command 
4010-HARDCOPY command 
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SELECT-VIEW Command 



4112,4113,4115 



Host Syntax 




Setup Syntax 



E cRC s p view-number 



PARAMETERS 

view-number (-1 to 64). 

Specifies the view you want to select. 

-1 the next lower-numbered 

the next higher-numbered view 

1 to 64 a specific view 

DESCRIPTION 

A view is defined by a set of viewing parameters and (possi- 
bly) a set of visible segments. There may be up to 64 views 
defined and each one may be independent of the others. 
Only one view may be selected to be current at a time. Into 
this current view go all actions such as unretained graphics, 
segments made visible, renew commands, etc. When a new 
view is designated as current, the attributes of the old view 
are remembered until the next time that view is selected. 

The SELECT-VIEW command specifies which view will be 
the current view. If the view has never been selected before, 
a new view (with the specified view number) is created. 



Creating a New View. When a new view is created in this 
manner, the view's parameters are set as follows: 

The window for the new view is the same as 
that for the old view. (That is, it has the same 
lower-left and upper-right corners in terminal 
space.) 

The full overview window and partial over- 
view window for the new view is the same as 
that for the old view. 



Window: 



Overview 
Windows. 



Viewport: The viewport for the new view is on the same 
surface, and has the same lower-left and 
upperright comers, as the viewport for the 
old view. 

Surface: The surface on which the viewport is 

displayed is the same as that for the old 
view. (It can be changed with the SET-VIEW- 
ATTRIBUTES command.) 

Segments: All segments which already exist remain in 
existence. However, none of these segments 
is visible in the new view. (Segment visibility 
applies only to a particular view. See SET- 
SEGMENT-VISIBILITY command.) 

Indices: The new view's wipe index and border index 

are the same as those for the old view. 
(These indices, and the surface number, can 
be changed with a SET-VIEW-ATTRIBUTES 
command.) 

Border: The visibility of the new view's border is the 

same as for the old view. (It can be changed 
with a SET-BORDER-VISIBILITY command 
or the BORDER key.) 
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Other View Numbers. Specifying view causes the termi- 
nal to select the next higher-numbered view of the existing 
numbered views. If there is no higher-numbered view in 
existence, then the lowest-numbered view is selected. This 
method of selecting the next view is equivalent to pressing 
the NEXTVIEW key, except that the view's border does not 
blink. 

Specifying view number -1 selects the next lower- 
numbered view of the existing numbered views. If no such 
lower-numbered view exists, then the highest-numbered 
view is selected. This method is equivalent to pressing 
CTRL-NEXTVIEW, except that the view's border does not 
blink. 



DEFAULTS 

view-number 
as shipped — 1 
on power-up — 1 
if omitted — 



ERRORS 

RCOO (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 41 13 or 41 15.) 

RC11 (Level 2): Invalid view-number. (Must range from -1 
to 64.) 



Default View. The "default view," created on power-up 
(or on a DELETE-VIEW: -1 command) has the following 
attributes: 

View number: 1 

Window: 4112,4113:X = OtoX = 4095, Y = Oto 

Y = 3127; 4115: X = OtoX = 4095, Y = Oto 

Y = 3276 

Full overview window: 41 1 5: X = to X = 4095, Y = to 

Y = 4095 
Partial overview window: 4115: X = OtoX = 4095, Y = 

to Y = 3276 
Viewport: 41 1 2, 41 1 3: X = 4095, Y = 3071 ; 41 1 5: 

X = 4095, Y = 3276 
Surface number: 1 
Border: invisible 
Graphic beam position: 4112,4113: (0,3071); 41 15: 

(0,3081) 
Wipe Index: 
Border Index: 4112: 6; 41 13, 4115: 1 



REFERENCES 

DELETE-VIEW command 
SET-SEGMENT-VISIBILITY command 
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SET-ALPHATEXT-FONT Command 

Host Syntax 




Setup Syntax 




PARAMETERS REFERENCES 

The s i character selects the standard alphatext font. The s o GRAPHIC-TEXT command 

character selects the APL font, if the terminal is equipped SET-GRAPHTEXT-PRECISION command 

with an APL keyboard or the Katakana font if the terminal is 

equipped with a Katakana keyboard. APL is not available on 

41 15 terminals. 

DESCRIPTION 

This command selects the font used for displaying alphatext 
on those terminals equipped with the APL keyboard, Option 
4E or the Katakana keyboard, Option 4K. E c s i selects the 
standard ASCII font, while E c s o selects the alternate font. 
The selected font is used for alphatext in the dialog area 
and on the screen, as well as for "string precision" 
graphtext. However, only the ASCII font is used in Setup 
mode. 

The APL font is not available on 41 1 5 terminals. If you send 
this command to a 41 1 5 terminal that does not have an 
optional keyboard installed, the command is ignored. 
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SET-ALPHATEXT-SIZE COMMAND 



4114,4116 



Host Syntax 



E cMZ M:size-multiplier \r\\:inter-character-spacing mtinterline-spacing 



Setup Syntax 



ALPHASIZE s p size-multiplier inter-character-spacing interline-spacing 



PARAME I fcRS 

size-multiplier (~\ to 16). 

Determines the size of the character. 

inter-character-spacing (0 to 1 5). 

Horizontal spacing between adjacent character cells. 

interline-spacing (0 to 255). 

Vertical spacing between one row of text and the next. 



DESCRIPTION 

The SET-ALPHATEXT-SIZE command is valid only in the 
41 14 and 41 16 terminals. 

This command determines the size of all subsequent 
alphatext, and the horizontal and vertical spacing between 
adjacent character cells. 

Figure 7-1 2 shows the meanings of the parameters. The 
first parameter is a multiplier of the basic character size, 
which is five units wide and six units high in 4096 x 4096 
terminal space. The next two parameters specify, in terminal 
space units, how far apart the character cells are spaced 
horizontally and vertically. 



The width and height of the dialog area viewport 
are specified by the number of characters per line 
the number of lines in view. Therefore, changing 
the alphatext character size will also change the 
dialog viewport dimensions. (Changing the 
dimensions can also change the position of the 
dialog area's lower left corner.) For details, see the 
descriptions of the SET-DIALOG-AREA-CHARS, 
SET-DIALOG-AREA-LINES, and SET-DIA- 
LOG-AREA-POSITION commands. 



DEFAULTS 

ci-TO-rrtiiltinlior 

as shipped — 1 

on power-up — remembered 

if omitted — error MZ1 1 

inter-character-spacing 
as shipped — 6 
on power-up — remembered 
if omitted — 

interline-spacing 
as shipped — 28 
on power-up — remembered 
if omitted — 
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ERRORS 

MZOO (Level 0): Unrecognized command. (Terminal is not 
a4114or4116.) 

MZ1 1 (Level 2): Invalid size-multiplier (must range from 1 
to 16). 

MZ21 (Level 2): Invalid inter-character-spacing (must 
range from to 1 5). 

MZ31 (Level 2): Invalid interline-spacing (must range from 
to 255). 



REFERENCES 

SET-4014-ALPHATEXT-SIZE command 
SET-DIALOG-AREA-CHARS command 
SET-DIALOG-AREA-LINES command 
SET-DIALOG-AREA-POSITION command 
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Figure 7-12. Meaning of SET-ALPHATEXT-SIZE Parameters. 
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SET-BACKGROUND-COLOR Command 



4112,4113,4115 



Host Syntax 



E cTB \ntfirst-color-coordinate mtsecond-color-coordinate mtthird-color-coordinate 



Setup Syntax 



E cTB s p first-color-coordinate second-color-coordinate third-color-coordinate 



PARAME I lhS 



DESCfiiPTiON 



The three color coordinates are either HLS, RGB, CMY, or 
(41 1 5 only) Machine RGB coordinates, according to the 
color-specifying-mode in the most recent SET-COLOR- 
MODE command. A blinking color can be specified by 
adding 1 000 to the value of the third-color-coordinate 
parameter. 

The valid ranges for the three parameters are: 
first-color-coordinate 



HLS 


-32768 to 32767 


RGB 


to 100 


CMY 


to 100 


Machine RGB 


to 255 



second-color-coordinate 
HLS to 100 

RGB to 100 

CMY to 100 

Machine RGB to 255 

third-color-coordinate 

HLS 0to100or1000to1100 

RGB to 100 or 1000 to 1100 

CMY 0to100or1000to1100 

Machine RGB to 255 or 1 000 to 1 255 



The SET-BACKGROUND-COLOR command sets the 
color of the background surface which is behind all the 
transparent writing surfaces. 

Whenever the background color is set, the background 
gray level is set to an equivalent NTSC gray level. The 
conversion formula that relates gray level to color is: 

Gray level = 30% (Red level) + 59% (Green level) + 
1 1 % (Blue level) 

The resulting gray level is always rounded to the nearest 
integer. 

Two other commands can be used to set the background 
color are SET-BACKGROUND-GRAY-LEVEL and SET- 
SURFACE-COLOR-MAP. 

Adding 1 000 to the value of the third-color-coordinate 
causes the color to blink by alternating between black and 
the specified color at a rate of 1 Vz cycles per second. For 
example, in HLS mode a normal red background is indi- 
cated by (120, 50, 100), and a blinking red background is 
given by (120, 50, 1100). 

NOTE 

If you specify a SUBTRACTIVE overlay mode in 
the set-color-mode command, then you should also 
specify a background color of white (or some other 
light color) with the SET-BACKGROUND- 
COLOR or SET-BACKGROUND-GRAY-LEVEL 
command. 
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DEFAULTS REFERENCES 

first-color-coordinate SET-BACKGROUND-GRAY-LEVEL command 

as shipped — SET-COLOR-MODE command 

on power-up — SET-SURFACE-COLOR-MAP command 
if omitted — 

second-color-coordinate 
as shipped — 
on power-up — 
if omitted — 

third-color-coordinate 
as shipped — 
on power-up — 
if omitted — 

ERRORS 

TBOO (Level 0): Unrecognized command (41 14 and 41 16 
only). 

TB1 1 (Level 2): Invalid first parameter. (If in HLS mode, 
must range from -32768 to 32767. If in 
RGB or CMY mode, must range from to 
100. If in 41 15 Machine RGB mode, must 
range from to 255.) 

TB21 (Level 2): Invalid second parameter (HLS, RGB, 
CMY must range from to 1 00, 41 1 5 
Machine RGB must range from to 255). 

TB31 (Level 2); Invalid third parameter (HLS, RGB, CMY 
must range from to 1 00 and 1 000 to 
1 100, 41 15 Machine RGB must range 
from to 255 and 1 000 to 1 255). 
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SET-BACKGROUND-GRAY-LEVEL Command 



4112,4113,4115 



Host Syntax 



E cRB mV.gray-level 



Setup Syntax 



E cRB s p gray-level 



DXDAMCTCDC 
mnMiviL i ^i^i«? 



gray-level (0 to 1 00 and 1 000 to 1 1 00). 

The "per-cent" of lightness to which the background 
(behind all writing surfaces) is set. represents black, 
while 1 00 represents white. Adding 1 000 to a gray level 
blinks the background. 

DESCRIPTION 

This command determines the gray level used on the 
screen for background. It is the value of the screen when no 
object or opaque view objects are present. 

Initial (minimum) value is "0% lightness," or black. 

Mayimi im yali to ic "1 DOO/n linhtnpcc " r\r whito 

Please read the discussion of the gray levels and gray 
indices and their meanings and assignments, included in 
the description of the SET-SURFACE-GRAY-LEVELS 
command. 



gray-level 

as shipped — 
on power-up — 
if omitted — 



ERRORS 



RB00 (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 41 13, or 41 15.) 

RB11 (Level 2): Invalid gray-level (must range from to 
100 and 1000 to 1100). 

REFERENCES 

SET-BACKGROUND-COLOR command 
SET-SURFACE-COLOR-MAP command 
SET-SURFACE-GRAY-LEVELS command 



If you add 1 000 to the gray level number, the background 
blinks by alternating between black and the specified 
gray-level. 

Whenever the background gray level is set, the background 
color is set to an equivalent gray level. 

Two other commands set the background gray level: SET- 
BACKGROUND-COLOR and SET-SURFACE-COLOR-MAP. 
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SET-BACKGROUND-INDICES Command 



4112,4113,4115 



Host Syntax 



E cMB mttext-background-index mV.dash-gap-index 



Setup Syntax 



ErMR S, 



cMB s p text-background-index dash-gap-index 



PARAMETERS 



DESCRIPTION 



text-background-index (-2 to 32767). 

Specifies the background index for string-precision 
graphtext and alphatext which is not displayed in the 
dialog area. 

-2 the wipe index for the current viewport 

-1 no index; the pixels in character back- 

grounds are left unchanged 

to 32767 a specific color index 

dash-gap-index (-2 to 32767). 

Determines the color index for the "gaps" in dashed 
lines. 

-2 the wipe index for the current viewport 

-1 no index; the pixels in the gaps in dashed 

lines are left unchanged 



to 32767 a specific color index 



The SET-BACKGROUND-INDICES command specifies the 
color indices used for the backgrounds of string-precision 
graphtext (and alphatext outside the dialog area). It also 
specifies the color index used for the "gaps" in dashed 
lines. 



Index -2. In this command, an index of -2 represents the 
wipe index for the current viewport. Specifying index -2 for 
the text background index is like specifying "replace mode" 
in the SET-GRAPHICS-AREA-WRITING-MODE command. 



Index -1. In the SET-BACKGROUND-INDICES command, 
an index of -1 means "no index." That is, it specifies that 
the character background (or dash gap) pixels are to be left 
unchanged. Specifying -1 for the character background 
index is like specifying "overstrike mode" in the SET- 
GRAPHICS-AREA-WRITING-MODE command. 



NOTE 

The SET-GRAPHICS-AREA- WRITING-MODE 
and SET-BA CKGROUND-INDICES commands 
both affect how alphatext is displayed in the 
graphics area. Thus, each of these commands 
supersedes the effect of the other. 
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DEFAULTS 



ERRORS 



text-background-index 

as shipped— -2 

on power-up — agrees with the remembered value for 
the SET-GRAPHICS-AREA-WRITING- 
MODE command (GAMODE command). 
If the GAMODE is REPLACE, the text- 
background index is -2; if GAMODE is 
OVERSTRIKE, the text text-background- 
index is -1. 

if omitted — 



MBOO (Level 0): Unrecognized command. (41 14 and 41 16 
only). 

MB11 (Level 2): Invalid text-background-index (must 
range from -2 to 32767). 

MB21 (Level 2): Invalid dash-gap-index (must range from 
-2 to 32767). 



REFERENCES 



dash-gap-index 
as shipped — -1 
on power-up — -1 
if omitted — 



SET-GRAPHICS-AREA-WRITING-MODE command 
SET-SURFACE-COLOR-MAP command 
SET-SURFACE-GRAY-LEVELS command 
SET-VIEW-ATTRIBUTES command 
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SET-BAUD-RATES Command 



Host Syntax 



E cNR \nt:transmit-data-rate mt.receive-data-rate 



Setup Syntax 



BAUDRATE s p transmit-data-rate receive-data-rate 



PARAMETERS 

transmit-data-rate. 

The rate, in bits per second, at which the terminal trans- 
mits characters to the host computer. Valid values are 1 
(which means "external clock"), 50, 75, 110, 134, 150, 
300, 600, 1200, 1800, 2400, 4800, 9600, 19200, and 
38400. 

receive-data-rate. 

The rate at which the terminal receives characters from 
the host computer. Valid values are (which means 
"same as transmit-rate", 1 (which means "external 
Clock"), 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 
2400, 4800, 9600, 19200, and 38400. 



DESCRIPTION 

Specifies the line data rates to be used for all subsequent 
communications. Split baud rates (different speeds for 
receiving and transmission) are allowed. 

The receiving rate is the rate at which the terminal expects 
to receive data. The transmission rate is the rate at which 
individual characters are clocked out of the terminal. 

Valid values of the data rate parameters are: 0, 1 , 50, 75, 
110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 4800, 
9600, 19200, and 38400 bits/second. 

A receive baud rate of zero means that the terminal is to use 
the same receive speed as the transmission rate. A transmit 
rate of zero is invalid. 



A receive or transmit rate of one means that the terminal is 
to use an external clock to determine its data rate. (The 
external clock would be provided on the RECEIVE CLOCK 
or TRANSMIT CLOCK input of the RS-232 connector.) 

In addition, you can specify a "transmit data rate limit" with 
the SET-TRANSMIT-RATE-LIMIT command, and a transmis- 
sion delay time with the SET-TRANSM IT-DELAY command. 
These commands control the effective maximum speed for 
the terminal-to-host communications, which may be less 
than the rate at which the terminal sends each individual 
character. 

The baud rates may be set by the operator in Setup mode, 
or they may be included as a SET-BAUD-RATES command 
in a file to be loaded from the terminal's disk drive. It is 
usually unwise to attempt to change the terminal's baud 
rates by command from the host computer. 



7-206 



4110 SERIES COMMAND REFERENCE 



TEK COMMANDS 



NOTE 

The 4112 and 4113 can display simple alpha- 
numerics and graphics only up to a maximum 
continuous data rate of 9600 bits/second. For the 
4114, 4115, and 4116 this maximum rate is 19200 
bits/second. (This does not include commands 
which require more than routine processing, such 
as the INCLUDE-COPY-OF-SEGMENT or 
LOAD commands.) At higher data rates, some 
"handshaking" protocol must be used to prevent 
the terminal's communications input queue from 
overflowing. 

Moreover, even at slow data rates, it is prudent to 
use a handshaking protocol. The terminal can take 
an appreciable amount of time to execute some 
commands — such as LOAD or SAVE : segments- 



all - 



vhich i 






characters. If a handshaking protocol is not used, 
the terminal's input queue may overflow while 
executing such commands. 

Such a handshaking protocol might be as simple as 
issuing a REPORT-4010-STATUS command from 
time to time, and waiting to receive the reply before 
issuing more commands to the terminal. Alterna- 
tively, any of several data communications proto- 
cols may be used : Flagging mode, Prompt mode, 
or Block mode. Any of these communications 
modes will prevent the input queue from 
overflowing. 



DEFAULTS 

transmit-data-rate 
as shipped — 2400 
on power-up — remembered 
if omitted — error NP1 1 

receive-data-rate 
as shipped — 2400 
on power-up — remembered 
if omitted — 



ERRORS 

NR11 (Level 2): Invalid transmit (terminai-to-host) data 
rate. (Must be 1, 50, 75, 110, 134, 150, 
300, 600, 1200, 1200, 1800, 2000, 2400, 
4800, 9600, 19200, or 38400.) 

NR21 (Level 2): invalid receive (host-to-terminal) data 

rate. (Must be 0, 1, 50, 75, 110, 134, 150, 
300, 600, 1200, 1800, 2000, 2400, 4800, 
9600, 19200, or 38400.) 



REFERENCES 

ARM-FOR-BLOCK-MODE command 
LOAD command 
PROMPT-MODE command 
SET-FLAGGING-MODE command 
SET-TRANSMIT-RATE-LIMIT command 
SET-TRANSM IT-DELAY command 
SET-PORT-BAUD-R.ATE command 
SET-QUEUE-SIZE command 
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SET-BLOCK-CONTINUE-CHARS Command 



OPTION 01 



Host Syntax 



E cOC M:transmit-continue-char mtreceive-continue-char 



Setup Syntax 



BCONTINUECHARS s p transmit-continue-char receive-continue-char 



PARAMETERS 

transmit-continue-char (0 to 1 27). 

The numeric equivalent of the continue-char for blocks 
transmitted from the terminal to the host. 

receive-continue-char (0 to 1 27). 

The numeric equivalent of the continue-char for blocks 
received by the terminal from the host. 

DESCRIPTION 

Sets the block-continue-chars which signal the end of lines 
within a block (other than the last line, which uses the 
block-end-char). 

This command is invalid if the terminal is armed for block 
mode. 

The block-continue-char signals the end of a line in a block, 
and indicates that there are more lines of the block to come. 



DEFAULTS 

transmit-continue-char 
as shipped — 38 
on power-up — remembered 
if omitted — 

receive-continue-char 
as shipped — 38 
on power-up — remembered 
if omitted — 



ERRORS 

OC00 (Level 2): 

OC03 (Level 2): 

OC11 (Level 2): 

OC13 (Level 2): 

OC21 (Level 2): 

OC23 (Level 2): 



Unrecognized command. (Option 1 is not 
installed.) 

Command is invalid at this time. (Terminal 
must not be armed for block mode.) 

Invalid transmit-continue-char. (Must 
range from to 127.) 

Transmit-continue-char must be different 
from block-master-char and block-end- 
char. 

Invalid receive-continue-char. (Must range 
from to 127.) 

Receive-continue-char musX be different 
from block-master-char and block-end- 
char. 



REFERENCES 

Block syntactic construct 
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SET-BLOCK-END-CHARS Command 



OPTION 01 



Host Syntax 




Setup Syntax 



BENDCHARS s p transmit-end-char receive-end-char 



PAKAMfc I fcKS 

transmit-end-char (0 to 1 27). 

Numeric equivalent of the block-end-char for blocks sent 
from the terminal to the host. 

receive-end-char (0 to 1 27). 

Numeric equivalent of the block-end-char for blocks 
received by the terminal from the host. 

DESCRIPTION 

This command, for use with Block mode, sets the block- 
end-chars for blocks sent to and from the terminal. 

This command is invalid if the terminal is armed for Block 
mode. 

The block-end-char signals that there are no more lines in 
the block. 



DEFAULTS 



ERRORS 

OE00 (Level 2): 

OE03 (Level 2): 

OE11 (Level 2): 

OE13 (Level 2): 

OE21 (Level 2): 

OE23 (Level 2): 



Unrecognized command. (Option 1 is not 
installed.) 

Command invalid at this time. (Terminal 
must not be armed for block mode.) 

Invalid transmit-end-char. (Must range 
from to 127.) 

Transmit-end-char must be different from 
block-master-char and block-continue- 
char. 

Invalid receive-end-char. (Must range from 
to 127.) 

Receive-end-char must be different from 
block-master-char and block-continue- 
char. 



REFERENCES 

Block syntactic construct 



transmit-end-char 
as shipped — 36 
on power-up — remembered 
if omitted — 

receive-end-char 
as shipped — 36 
on power-up — remembered 
if omitted — 
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SET-BLOCK-HEADERS Command option 01 

Host Syntax 




Setup Syntax 




PARAMETERS DESCRIPTION 

transmit-header. Sets the transmit and receive header sequences for block 

Numeric equivalents (range to 1 27) of one to ten char- mode. (Here, transmit-header means the header sequence 

acters. These characters comprise the block-header for for blocks sent from the terminal to the host computer; 

blocks sent from the terminal to the host. receive-header means the header for blocks sent from the 

host to the terminal.) Each header is specified as an int- 

receive-header. array, where the ints in the array are the numeric equiva- 

Similar to the transmit-header, but for blocks received lents of the ASCII characters in the header. There may be 

from the host. one to ten characters in each header. 

This command is invalid if the terminal is armed for block 
mode. 

NOTE 

You should use different strings for the transmit 
and receive block headers. Otherwise, echoes from 
the host of blocks which the terminal transmits 
would be interpreted by the terminal as blocks 
coming from the host program. 
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DEFAULTS REFERENCES 

transmit-header Block syntactic construct 

as shipped — 6HEADTX 
on power-up — remembered 
if omitted — error OH1 1 

receive-header 

as shipped — 6HEADRX 
on power-up — remembered 
if omitted — error OH21 



ERRORS 

OH00 (Level 2); Unrecognized command. (Option 1 is not 
installed.) 

OH02 (Level 3): Out of memory while performing 
command. 

OH03 (Level 2): Command Invalid at this time. (Terminal 
must not be armed for block mode.) 

OH1 1 (Level 2): Invalid char (must be to 1 27) or array 
count (must be in range 1 to 10) in 
transmit-header. 

OH12 (Level 3): Out of memory while parsing the 
parameter. 

OH21 (Level 2): Invalid char (must be to 127) or array 

count (must be in range 1 to 1 0) in receive- 
header. 

OH22 (Level 3): Out of memory while parsing the 
parameter. 
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SET-BLOCK-LENGTH Command 



OPTION 01 



Host Syntax 



E cOS \nttransmit-block-length mX.receive-block-length 



Setup Syntax 




PARAMETERS 



DEFAULTS 



transmit-block-length (5 to 65535). 

Maximum length in bytes of unpacked data in blocks 
which the terminal sends to the host. 

receive-block-length (5 to 65535). 

Maximum length in bytes of unpacked data in blocks 
received from the host. 



DESCRIPTION 



transmit-block-length 
as shipped — 256 
on power-up — remembered 
if omitted — error OS1 1 

receive-block-length 
as shipped — 256 
on power-up — remembered 
if omitted — error OS21 



Sets the block lengths for transmitted and received blocks 
in block mode. (Here, "transmitted block" means a block 
which the terminal sends to the host; "received block" 
means a block which the host sends to the terminal.) 

The specified block length is the number of data bytes, 
including the four control bytes, before packing. The actual 
number of characters transmitted over the line will be 
greater because of the packing and formatting overhead. 
(For more information on the packing of data, see the 
description of the SET-BLOCK-PACKING command.) 

This command is invalid if the terminal is already in block 
mode, or if it is already armed for block mode. 



ERRORS 

OS00 (Level 2): Unrecognized command. (Option 1 is not 
installed.) 

OS03 (Level 2): Command invalid at this time. (Terminal 
must not be in block mode or armed for 
block mode.) 

OS1 1 (Level 2): Invalid transmit-block-length (must range 
from 5 to 65535.) 

OS21 (Level 2): Invalid receive-block-length (must range 
from 5 to 65535.) 



REFERENCES 

Block syntactic construct 
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SET-BLOCK-LINE-LENGTH Command 



OPTION 01 



Host Syntax 



E cOL mtmaximum-line-length 



Setup Syntax 



BLINELENGTH s p maximum-line-length 



PARAMETERS 



nccAi ii to 

LJ>Kmt MUL I W 



maximum-iine-lengih (1 2 to 65535). 

The maximum number of characters in each line of a 
block which the terminal sends to the host. 



DESCRIPTION 

The SET-BLOCK-LINE-LENGTH command sets the 
maximum number of characters in each "line" of a block 
which the terminal sends to the host in block mode. 

When comparing the length of a line with this maximum line 
length, the "line length" includes the header characters, 
the characters of packed data, and the block-continue-char 
or block^end-char . Not included are the characters In the 
EOL-string. (See block for details.) 

You should choose a maximum line length which does not 
exceed the capacity of the host computer's input buffer. 
That is, the maximum-line-length in the SET-BLOCK-LINE- 
LENGTH command, plus the characters in the EOL-string, 
should not exceed the host's input buffer size. 

When the terminal sends characters in block mode, it 
counts the characters of packed data on each line as it 
sends them. When the character count reaches one less 
than the current maximum-line-length setting, the terminal 
ends the line by sending the block-continue-char and the 
current EOL-string. 

This command is invalid if the terminal is already in block 
mode, or if it is already armed for block mode. 



maximum-line-length 
as shipped — 70 
on power-up — remembered 
if omitted — error OL1 1 



ERRORS 

OL00 (Level 2): Unrecognized command. (Option 1 not 
installed.) 

OL03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OL1 1 (Level 2): Invalid maximum-line-length. (Must range 
from 12 to 65535.1 



REFERENCES 

Block syntactic construct 
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SET-BLOCK-MASTER-CHARS Command 



OPTION 01 



Host Syntax 




Setup Syntax 



BMASTERCHARS s p transmit-master-char receive-master-char 



PARAMETERS 



DEFAULTS 



transmit-master-char (0 to 1 27). 

The numeric equivalent of the block-master-char for 
blocks sent from the terminal to the host. 

receive-master-char (0 to 1 27). 

The numeric equivalent of the block-master-char tor 
blocks received from the host. 



DESCRIPTION 



transmit-master-char 
as shipped — 35 
on power-up — remembered 
if omitted — 

receive-master-char 
as shipped — 35 
on power-up — remembered 
if omitted — 



Sets the master characters for block mode transmission 
and reception. 

This command is used in conjunction with the SET-BLOCK- 
NON-XMT-CHARS command. When the host or terminal 
would otherwise have occasion to send one of the non- 
transmittable characters, it sends instead the "master char- 
acter," followed by another character. This two-character 
combination substitutes for the non-transmittable character. 

This command is invalid if the terminal is armed for block 
mode. 

For the terminal to properly recognize the block-master- 
chars they must be different than the block-continue-char 
and the block-end-char. 



ERRORS 

OM00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OM03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OM 1 1 (Level 2): Invalid transmit-master-char (0 to 1 27). 

OM13 (Level 2): Transmit-master-char must be different 
from block-end-char and block-continue- 
char. 

OM21 (Level 2): Invalid receive-master-char (0 to 1 27). 

OM23 (Level 2): Receive-master-char must be different 

from block-end-char and block-continue- 
char. 



REFERENCES 

SET-BLOCK-NON-XMT-CHARS command 
SET-BLOCK-PACKING command 
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SET-BLOCK-NON-XMT-CHARS Command 



OPTION 01 



Host Syntax 




Setup Syntax 



BNONXMTCHARS s p transmit-chars receive-chars 



KAKAMtTERS 



DESCRIPTION 



transmit-chars. 

An int-array in which each int represents an ASCII char- 
acter which may not appear in the packed-data of a block 
sent from the terminal to the host. Each int in the array 
must be in the range from to 1 27. 

receive-chars. 

Similar to the first parameter, but for blocks received by 
the terminal from the host. 



Sets the non-transmittable characters for the terminal to 
transmit and receive (to and from the host) while in block 
mode. Whenever the terminal or host computer would 
otherwise send one of these characters within the charac- 
ters of packed data, it (the terminal or host) substitutes a 
two-character sequence : the "master character," followed 
by a character which substitutes for the non-transmittable 
character. The substitution characters are assigned as fol- 
lows: for the first non-transmittable character, the letter (A); 
for the second non-transmittable character, the letter (B); 
etc. 



The master character, block-continue character, and block- 
end character must not be allowed to occur within the 
characters of packed data, if the packing scheme (chosen 
with the set-block-packing command) permits this to occur, 
then those characters must be designated as "non- 
transmittable" characters. 

This command is invalid if the terminal is already in block 
mode, or if it is armed for block mode. 
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DEFAULTS 



REFERENCES 



transmit-chars 

as shipped — 35, 36, 38 
on power-up — remembered 
if omitted — empty array 

receive-chars 

as shipped — 35, 36, 38 
on power-up — remembered 
if omitted — empty array 



SET-BLOCK-MASTER-CHARS command 
SET-BLOCK-PACKING command 



ERRORS 

ON00 (Level 2): Unrecognized command. (Option 1 is not 
installed.) 

ON03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

ON11 (Level 2): Invalid character code or array count in 
transmit-chars array. (The array count 
must range from to 20, and the charac- 
ter codes must range from to 1 27.) 

ON 12 (Level 3): Out of memory while parsing the 
parameter. 

ON21 (Level 2): Invalid character code or array count in 
receive-chars array. (The array count must 
range from to 20, and the character 
code must range from to 1 27.) 

ON22 (Level 3): Out of memory while parsing the 
parameter. 
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SET-BLOCK-PACKING Command 7-217 

SET-BLOCK-TIMEOUT Command 7-219 

SET-BORDER-VISIBILITY Command 7-220 

SET-BREAK-TIME Command 7-221 

SET-BYPASS-CANCEL-CHAR Command 7-222 

SET-COLOR-COPIER-DATA-RESOLUTION Command 7-223 
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SET-COORDINATE-MODE Command 7-226 

SET-CURRENT-MATCHING-CLASS Command 7-228 

SET-DIALOG-AREA-ALTERNATE-INDEX Command 7-229 

SET-DIALOG-AREA-BUFFER-SIZE Command 7-230 

SET-DIALOG-AREA-CHARS Command 7-231 

SET-DIALOG-AREA-INDEX Command 7-232 

SET-DIALOG-AREA-LINES Command 7-234 

SET-DIALOG-AREA-POSITION Command 7-235 

SET-DIALOG-AREA-SURFACE Command 7-236 

SET-DIALOG-AREA-VISIBILITY Command 7-237 

SET-DIALOG-AREA-WRITING-MODE Command 7-239 

SET-DMA-BLOCK-SIZE Command 7-240 

SET-DRAW-BOUNDARY-MODE Command 7-241 

SET-DUPLEX-MODE Command 7-242 

SET-ECHO Command 7-243 

SET-EDIT-CHARS Command 7-244 

SET-EOF-STRING Command 7-246 

SET-EOL-STRING Command 7-248 
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SET-BLOCK-PACKING Command 



OPTION 01 



Host Syntax 



E cOP \n\:transmit-unpacked-bits mV.transmit-packed-bits \n\:receive-unpacked-bits mtreceive-packed-bits 



Setup Syntax 



BPACKING s p transmit-unpacked-bits transmit-packed-bits receive-unpacked-bits receive-packed-bits 



PARAMETERS 

transmit-unpacked-bits (7 or 8). 

The number of bits per byte of unpacked-data in blocks 
sent from the terminal to the host. 

transmit-packed-bits (6, 7, or 8). 

The number bits per "pseudo-byte" in the packed-data 
of blocks sent from the terminal to the host. 

receive-unpacked-bits (7 or 8). 

Like transmit-unpacked-bits, but for blocks received by 
the terminal from the host. 

receive-packed-bits (6, 7, or 8). 

Like transmit-packed-bits, but for blocks received from 
the host. 



h ito a reduced character set for trai Amission over a host/ 
communications system having limited transmission 
capability. 



Converting to a Stream of Binary Bits. The data to be 
transmitted is considered to be a long string of 7-bit or 8-bit 
bytes layed "end to end," forming one long string of binary 
bits. The first bit is the high-order bit of the first byte; the last 
bit is the low-order bit of the last byte. 



Composing Pseudo-Bytes and then the Actual Characters 
To Be Transmitted. Next the stream is divided into a series 
of "pseudo-bytes" of 6, 7, or 8 bits each. An offset is added 
to each pseudo-byte, thereby converting it into a standard 
ASCII character; Table 7-21 shows the offset which is added 
for each allowable pseudo-byte size: 



DESCRIPTION 

This command determines how characters to be sent in 
block mode are packed before being included among the 
"packed data" in a block. 

The command is invalid if the terminal is already in block 
mode, or if it is armed for block mode. 

The command has four int parameters; the first two govern 
block mode transmissions from the terminal to the host 
computer, while the second two govern transmissions from 
the host to the terminal. 

The purpose of packing is to convert the full seven-bit 
ASCI! character set (or a set of eight-bit full binary bytes) 



Table 7-21 
PACKED PSEUDO-BYTE CHARACTERISTICS 



Number of 
meaningful 
data bits per 
pseudo-byte 



Offset added 
to make a 
standard ASCII 
character 



32 



Range of possible ASCII 
decimal equivalents 
for the characters 
transmitted 



32 to 95 ASCII characters 
from s pto_ 



to 127 

Fuil ASCII character set 



to 255 

Full eight-bit data bytes 
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When the end of a block is processed, if there are not 
enough bits to fill out the last pseudo-byte, an appropriate 
number of zeroes are appended to the end of the stream of 
bits. On input, this padding is ignored. Note that padding is 
inserted only at the end of a block and not at the end of a 
line within a block. 



DEFAULTS 

transmit-unpacked-bits 
as shipped — 7 
on power-up — remembered 
if omitted — error OP1 1 

transmit-packed-bits 
as shipped — 6 
on power-up — remembered 
if omitted — error OP21 

receive-unpacked-bits 
as shipped — 7 
on power-up — remembered 
if omitted — error OP31 

receive-packed-bits 
as shipped — 6 
on power-up — remembered 
if omitted — error OP41 



ERRORS 

OP00 (Level 2): 

OP03 (Level 2): 

OP11 (Level 2): 

OP21 (Level 2): 

OP31 (Level 2): 

OP41 (Level 2): 



Unrecognized command. (Option 1 is not 
installed.) 

Command invalid at this time. (Terminal 
must not be armed for block mode.) 

Invalid transmit-unpacked-bits (must be 
7 or 8). 

Invalid transmit-packed-bits (must be 6, 
7, or 8). 

Invalid receive-unpacked-bits (must be 
7 or 8). 

Invalid receive-packed-bits (must be 6, 
7, or 8). 



REFERENCES 

Block syntactic construct 
Block-control-bytes syntactic construct 
SET-BLOCK-CONTINUE-CHARS command 
SET-BLOCK-END-CHARS command 
SET-BLOCK-HEADERS command 
SET-BLOCK-MASTER-CHARS command 
SET-BLOCK-NON-XMT-CHARS command 
SET-EOM-CHARS command 
SET-EOL-STRING command 
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SET-BLOCK-TIMEOUT Command 



OPTION 01 



Host Syntax 



E cOT mV.number-of-seconds 



Setup Syntax 




PARAMETERS 

number-of-seconds (0 to 65535). 

Duration of timeout period in seconds. disables the 
timeout feature. 



DESCRIPTION 

In block mode, when the terminal sends a block to the host, 
it expects an "ACK" block to come back from the host. If the 
terminal does not receive that ACK within a certain period of 
time, it re-transmits the block. The SET-BLOCK-TIMEOUT 
command determines how long the teminal waits before 
retransmitted the block. 

i« *u~ :«» r^-nm^+n*. im. tl-ilo nrsmmanA ic than thp "rotranc. 

II II IO till paidllicl'CI 111 li no wvJiiliitCtiivi iS *J, ii>di itiG i V t> ul , v 

mit on timeout" feature is disabled. 

The timeout parameter should be set to a value which is 
longer than the maximum expected host response time. 



DCEAIII TC 

number-of-seconds 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

OT00 (Level 2): Unrecognized command. (Option 1 is not 
installed.) 

OT1 1 (Level 2): Invalid number-of-seconds. (Must range 
from to 65535 seconds.) 



REFERENCES 

Block syntactic construct 
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SET-BORDER-VISIBILITY Command 



4112,4113,4115 



Host Syntax 



E cRE \n\:border-visibility-mode 



Setup Syntax 



EfRP S, 



cRE s p border-visibility-mode 



PARAMETERS 

border-visibility-mode (0, 1 , or 2). 

Specifies whether the border of the current view is visible 
or invisible. 



invisible 

visible 

toggles the border visibility: if visible, it 
becomes invisible; if invisible, it becomes 
visible. 



viewport. (For a description of ALU mode 1 1 , see the 
BEGIN-PIXEL-OPERATIONS command. For a descrip- 
tion of the background wipe index, see SET-VIEW- 
ATTRIBUTES.) 

If the parameter is 0, the border around the current viewport 
is made invisible. 

If the parameter is 2, the border is toggled. That is to say, if 
the border is visible, it is made invisible; and if it is invisible, 
it is made visible. 



DESCRIPTION 

The command controls the visibility of a border drawn 
around the current view's viewport. 

If the parameter is 1 , the current view is displayed with a 
border drawn around its viewport. The border is drawn as a 
solid line, just within the viewport. It is drawn in the color 
index specified by the SET-VIEW-ATTRIBUTES command 
for that view. (If no SET-VIEW-ATTRIBUTES command has 
been issued, the border is drawn with the highest possible 
color index for the surface on which the viewport appears 
on the 41 1 2. On the 41 1 3 and 4115, the border is drawn 
with index 1 .) 



DEFAULTS 

border- visibility-mode 
as shipped — 
on power-up — 
if omitted — 



ERRORS 

RE00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RE1 1 (Level 2): Invalid border-visibility-mode parameter 
(must be 0, 1,or2). 



The border is always drawn in Set mode (ALU mode 1 1 ) so 
that it overwrites the pixels below it. The border is removed 
by writing over the border, again in Set mode, with the 
background wipe index for the viewport. Thus turning the 
border on and off will erase any pixels on the border of the 



REFERENCES 

BEGIN-PIXEL-OPERATIONS command 
BORDER Key 
SET-VIEW-ATTRIBUTES command 
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Host Syntax 



E cNK \ntbreak-time-in-milliseconds 



Setup Syntax 



BREAKTIME s p break-time-in-milliseconds 



PARAMETERS 

break-time-in-milliseconds (0 to 65535). 

Approximate duration of a "break" signal. Zero causes 
no break signal to be sent. 

DESCRIPTION 

This command sets the length of the BREAK function in 
milliseconds. The actual break time is as close as possible 
(that is, within 25 ms) to the value specified, determined by 
the terminal clock resolution. The default break time delay 
is 200 ms. 

When the BREAK Key is pressed, the terminal sends a 

"cna^" Ipl r\r\r\r\aarl tr» o "marlr" in tolonranh tprm'mnlnrnA 

to the host computer. The "space" (a positive voltage on the 
RS-232 connector's TDATA line) lasts for a sufficient time 
that the host computer (or the data communications equip- 
ment) will recognize that the terminal is not sending a valid 
ASCII character. 

(In Half Duplex Supervisor mode, the BREAK Key causes 
the modem to stop sending its secondary carrier for the 
designated length of time.) 

On almost all systems, a break time of 200 ms will work well. 
Use the SET-BREAK-TIME command to change the default 
setting only if the 200 ms break time does not work well on 
your system. 



The terminal remembers its break time setting even when 
turned off; thus, the SET-BREAK-TIME command need only 
be given when the terminal is installed. (In the vast majority 
of cases, the command need not even be given then, as the 
default 200 ms break time will suffice.) 

Setting a break time of zero effectively disables the BREAK 
key; this may be useful for host systems which do not toler- 
ate breaks. 



DEFAULTS 

break-time-in-milliseconds 
as shipped — 200 
on power-up — remembered 
if omitted — 



ERRORS 

NK1 1 (Level 2): Invalid break-time-in-milliseconds. (Must 
range from to 65535.) 

REFERENCES 

BREAK Key 
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SET-BYPASS-CANCEL-CHAR Command 



Host Syntax 



E cNU \r\X:bypass-cancel-char 



Setup Syntax 



BYPASSCANCEL s p bypass-cancel-char 



PARAMETERS 

bypass-cancel-char (0 to 1 27). 

ASCII decimal equivalent of the bypass cancel character. 

DESCRIPTION 

The SET-BYPASS-CANCEL-CHAR command defines which 
ASCII character is to serve as the bypass-cancel-character 
for removing the terminal from bypass mode. 

The bypas-cancel-character is the character that removes 
the terminal from Bypass mode when it is received by the 
terminal. 

If the character is set to N u — ASCII decimal equivalent 
(ADE) of — then the Bypass mode is disabled and cannot 
be entered. 

If your host does not echo any characters sent to it, set the 
bypass-cancel-character to N u (ADE 0). If your host echoes 
any characters, set the bypass-cancel-character to the 
last character which the host echoes upon receiving an 
EOL-string. 

For instance, suppose that the current EOL-string consists 
of the single character, c r, and that the host computer 
echoes each c r as c r l f. Then, as the terminal sends reports 
and files to the host, the last character in each line sent to 
the host is c r, and the last character in the echo of each 
such line is l f. The l f character, then, should be selected as 
the bypass-cancel-char. Since the ASCII decimal equivalent 
of l f is 10, this can be done with a SET-BYPASS-CANCEL- 
CHAR : 10 command: 

set-bypass-cancel-char: 10 = E cNUint: 10 

= E cNU: 



NOTE 

Unlike earlier Tektronix terminals, there can be 
only one bypass-cancel-character at a time on the 
41 10-series terminals. Also, unlike the 4014, the 
bypass-cancel-char is not executed upon receipt. 

For more information on bypass mode, see the ENTER- 
BYPASS-MODE command. 



DEFAULTS 

bypass-cancel-char 
as shipped — 10 
on power-up — remembered 
if omitted — 



ERRORS 

NU11 (Level 2): Invalid numeric equivalent of bypass- 
cancel character. (Must be in the range 
from to 127.) 

REFERENCES 

ENTER-BYPASS-MODE command 
SET-EOL-STRING command 
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SET-COLOR-COPIER-DATA-RESOLUTION Command 



OPTION 09 



Host Syntax 



E cQB m\:number-of-bytes 



Setup Syntax 



HCDATARES s p number-of-bytes 



DADAUETCDC 
rni mini- i wi iw 

number-of-bytes (1 or 2). 

Specifies how many bytes of color resolution the data 
sent to a color copier will have. 

1 one byte coior resolution 

2 two bytes color resolution 

DESCRIPTION 

This command sets the precision of the color resolution of 
the data sent from the terminal to the copier for each of 
three colors; red, green, and blue (RGB). 

If you assign one byte of color resolution, data transfers are 
faster when the information is transferred using the copy 
command with a source string parameter of "SC:" or when 
a hardcopy is performed on a 41 1 3 or 41 1 5 with Option 9 
installed and the SET-HARDCOPY-INTERFACE command 
set to the color hardcopy interface. Also, disk storage space 
is saved when data formatted by the "SC:" source is stored. 
One byte of color resolution contains two bits of information 
for each of the three colors. 

If you assign two bytes of color resolution, the color is more 
precisely copied from the actual terminal color when a 
hardcopy is performed (with a hardcopy command, the 



HARD COPY key, or when the destination device is HC: for 
either the COPY or SPOOL command). Two bytes of color 
precision, contain four bits of information for each of the 
three colors. 



DEFAULTS 



number-of-bytes 
as shipped — 1 
on power-up — rembered 
if omitted — error QB1 1 



ERRORS 

QB00 (Level 0): Unrecognized command (Option 9 is not 
installed^. 

QB1 1 (Level 2): Invalid number-of-bytes (must be 1 or 2). 



REFERENCES 

COPY command 
HARDCOPY command 
HARD COPY key 

SET-HARDCOPY-INTERFACE command 
SPOOL command 
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SET-COLOR-MODE Command 



4112,4113,4115 



Host Syntax 




Setup Syntax 



CMODE s p color-specifying-mode color-overlay-mode gray-mode 



PARAMETERS 

color-specifying-mode (41 1 2, 41 1 3: to 3; 41 1 5: to 4). 
Determines which system of color coordinates is used to 
specify color mixtures in subsequent color operations. 

no change 

1 RGB (red, green, blue) 

2 CMY (cyan, magenta, yellow) 

3 HLS (hue, lightness, saturation; default) 

4 Machine RGB (41 15 only) 

color-overlay-mode (0 to 3). 

Specifies which mode is used when colors are placed on 
top of each other. 






no change 


1 


OPAQUE 


2 


SUBTRACTIVE 


3 


ADDITIVE 



gray-mode (0 to 2). 

Specifies whether operation is color or black and white. 

no change 

1 COL; normal color operation (the default for 
4113,4115) 

2 BW; displays color images in black and white 
(default for 41 12) 



DESCRIPTION 

This command sets three "color mode" parameters for the 
41 12, 41 13, and 41 15 terminals. 



Color-Specifying-Mode. The color-specifying-mode param- 
eter determines which of the three systems of color coordi- 
nates is used for specifying color mixtures in subsequent 
SET-SURFACE-COLOR-MAP and SET-BACKGROUND- 
COLOR commands. If this parameter is 0, or is omitted, the 
color specifying mode is left unchanged. 

The default on power-up is "HLS." In the HLS system, 
colors are specified by hue, lightness, and saturation co- 
ordinates on the color cone. See Appendix E for details 
about the HLS color cone. 

The RGB system determines a color mixture by adding 
together different proportions of the additive primary colors: 
red, green, and blue light sources. The RGB system closely 
resembles the actual operation of the terminal's color dis- 
play hardware. 

The CMY system mixes different proportions of the subtrac- 
tive primary colors: cyan, magenta, and yellow inks. The 
terminal's CMY mode emulates the mixing of the cyan, 
magenta, and yellow pigments used in many printing 
processes. 

On the 41 15, Machine RGB mode increases the resolution 
in red, green, and blue from that available with the regular 
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RGB mode (0 to 1 00) to the number of bits in each color that 
are available at the output of the color map. The valid range 
is to 255. 



Color-Overiay-Mode. The color-overlay-mode parameter 
specifies the behavior of the terminal's writing surfaces. 
If this parameter is zero, the color overlay mode is left 
unchanged. 

In OPAQUE mode (mode 1), pictures drawn on a surface are 
deemed to be opaque; they obscure pictures drawn on 

9Ui laucs uci in iu ii ion i. vvnoi i u 10 iciiini iai 10 lut i icu \j\ i, il id 

in OPAQUE mode. 

In SUBTRACTIVE mode (mode 2), pictures are drawn using 
transparent inks. The terminal behaves like a "light table," 
in which transparent overlays are placed on top of a diffus- 

inn linht sniirw 



NOTE 

If you specify the SUBTRACTIVE color-overlay- 
mode in the SET-COLOR-MODE command, then 
you should also specify a background color of 
white (or some other light color) with the SET- 
BACKGROUND-COLOR or SET-BACK- 
GROUND-GRAY-LEVEL command. 

In ADDITIVE mode (mode 3), the images drawn on different 
surfaces act as if their colored inks were comprised of many 
small point light sources. Where colors on one surface 
overlap with colors on another surface, the light from the 
two surface's light sources combine. For instance, a red 
object on one surface and a green object on another sur- 
face would combine to produce a yellow color where the two 
objects overlap. 



The resulting gray level value is always rounded to the 
nearest integer. 

The 41 1 2 terminal ignores this parameter and always inter- 
prets color commands as if it is in BW mode, it also always 
reports 2 when queried for gray-mode. A 41 1 2 can never 
leave BW mode. 



DEFAULTS 

color-specifying-mode 
as shipped — 3 
on power-up — 3 
if omitted — 

color-overlay-mode 
as shipped — 1 
on power-up — 1 
if omitted — 

gray-mode 

as shipped — 41 1 2: 2; 41 1 3, 41 1 5: 1 
on power-up — 41 1 2: 2; 41 1 3, 41 1 5: 1 
if omitted — 



ERRORS 

TM00 (Level 0): Unrecognized command (terminal is not a 
4112,4113, or 41 15). 

TM11 (Level 2): Invalid color-specifying-mode (4112, 
41 13:0 to 3; 41 15:0 to 4). 

TM21 (Level 2): Invalid color-overlay-mode (must range 
from to 3). 

TM31 (Level 2): Invalid gray-mode (must be 0, 1 , or 2). 



Gray-Mode. The gray-mode parameter determines whether 
colors are displayed in color or in black and white. If this 
parameter is 0, or is omitted, the gray mode is left 
unchanged. COL mode (mode 1 ) causes the 41 1 3 and 41 1 5 
to operate normally as a color graphics terminal. When a 
41 1 3 or 41 1 5 terminal is turned on, it is in COL mode. BW 
mode (mode 2) causes colors to appear as shades of gray, 
according to the NTSC transform: 

Gray level = 30°/o(Red level) + 59%(Green level) + 
1 1 %(Blue level) 



REFERENCES 

Appendix E, "Color Coordinate Systems" 
SET-BACKGROUND-COLOR command 
SET-BACKGROUND-GRAY-LEVEL command 
SET-SURFACE-DEFINITIONS command 
SET-SURFACE-COLOR-MAP command 
SET-SURFACE-PRIORITIES command 
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SET-COORDINATE-MODE Command 



4115 



Host Syntax 



E cUX \n\:coordinate-mode \r\\:intc-report-size 



Setup Syntax 




PARAMETERS 

coordinate-mode (0 or 1). 

Specifies the format of xy coordinates: 

12-bit format: 

xy = [HiY] [Extra] LoY [HiX\\ LoX 

1 32-bit format: xy = \r\\:x-coord inty-coord 

intc-report-size (0, 2 to 6). 

Specifies the number of characters in succeeding intc- 
reports sent from the terminal to the host: 





2 



no change 



Two 


HULoI. 


+ 1023 


characters 






Three 


HUHULoI. 


+ 65535 


characters 






Four 


HilHUHil 


+ 2 22 -1 


characters 


Lol. 




Five 


HilHUHil 


+ 2 28 -1 


characters 


HULoI. 




Six 


HilHUHil 


- 2 31 to 2 31 -1 


characters 


HUHULoI. 





DESCRIPTION 



The SET-COORDINATE-MODE command determines: 

• The format for xy parameters sent from the host to the 
terminal. 



The format for xy-reports sent from the terminal to the 
host for all xy-reports including 

4010-GIN-Report 

4010-Status-Report 

4953-GIN-Report 

The length of intc-report parameters sent to the host 



Coordinate Mode 0. In coordinate mode (the default), the 
terminal recognizes xy parameters in the 1 2-bit format. See 
the description of the xy parameter type for details. 

All coordinates are absolute, explicitly defining points with 
values from to 4095. X Y-reports^are in either 1 2-bit or 1 0- 
bit format, depending on the command that caused them. 



Coordinate Mode 1 . Coordinate mode 1 allows addressing 
of the entire 32-bit terminal space. X Y and xy-report param- 
eters take the following forms: 

xy = \ntx-coord mty-coord 

xy-report = intc-report:x-coo/tf 
i ntc- report :y -coord 

In Coordinate mode 1 , xy's are sometimes absolute and 
sometimes relative. In all escape sequence commands, all 
xy's are absolute, and all xy-arrays start with an absolute 
coordinate, followed by points relative to the previous 
accmulated xy values within the context of the array. After 
an ENTER-VECTOR-MODE or ENTER-MARKER-MODE 
command, the first xy is absolute, and the following xys are 
relative to the accumulated xy values within the context of 
the current beam position. 
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Intc-report-Size. This parameter specifies the length of intc- 
reports that the terminal sends to the host when it sends xy- 
reports in Coordinate mode 1 , and for the 
terminal-settings-report for the SET-GRAPHTEXT-SIZE 
Intc-reports may be two through six characters long. 

DEFAULTS 



ERRORS 

UXOO (Level 0): Unrecognized command. (Terminal is not 
a4115.) 

UX1 1 (Level 2): Invalid coordinate-mode (must be or 1 ). 

UX21 (Level 2): Invalid intc-report-size (must be 0, or 
2 to 6). 



coordinate-mode 
as shipped — 
on power-up — 
if omitted — 

intc-report-size 
as shipped — 3 
on power-up — 3 
if omitted — 



b l character 

ENTER-MARKER-MODE command 
ENTER-VECTOR-MODE command 
Int parameter type 
Intc-report parameter type 
Terminal-settings-report message type 
SET-GRAPHTEXT-SIZE command 
XY parameter type 
XY-report parameter type 
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SET-CURRENT-MATCHING-CLASS Command 



Host Syntax 



E cSL \n\-axray.inclusion-set m\-array:exclusion-set 



Setup Syntax 



E cSL s p inclusion-set exclusion-set 



PARAMETERS 

inclusion-set (-1 , 1 to 64). 

The set of classes used in the inclusion part of a match- 
ing operation. 

-1 all attributes 

1 to 64 a specific attribute 

exclusion-set (-1 , 1 to 64). 

The set of classes used in the exclusion part of a match- 
ing operation. 

-1 all attributes 

1 to 64 a specific attribute 

DESCRIPTION 

This command establishes the inclusion and exclusion sets 
used in matching operations. 

A matching operation is done for each defined segment 
(except segment 0, the crosshair cursor) when segment- 
number -3 is specified in a segment command. 

The matching operation is: 

IF The segment's class set intersected with the inclu- 

sion set equals the inclusion set. 

AND The segment's class set intersected with the exclu- 
sion set equals the empty set. 

THEN The command is performed on the segment. 

Otherwise, the command is not performed on the segment. 

The elements in the inclusion-set and exclusion-set parame- 
ters represent user-selected attributes to be included or 



excluded in the current matching class. There are 64 possi- 
ble attributes (1 to 64), and all combinations are valid. If you 
assign -1 as a member of either set, that set includes all 
attributes. For a detailed discussion of segment matching 
classes see the 4110 Series Host Programmers Manual. 

DEFAULTS 

inclusion-set 

as shipped — empty array 
on power-up — empty array 
if omitted — empty array 

exclusion-set 

as shipped — empty array 
on power-up — empty array 
if omitted — empty array 

ERRORS 

SL1 1 (Level 2): Invalid inclusion-set array. (Class numbers 
must be -1 , or 1 to 64. Count must be 
to 65535.) 

SL12 (Level 3): Out of memory while parsing the 
parameter. 

SL21 (Level 2): Invalid exclusion-set. (Class numbers 
must be -1 , or 1 to 64. Count must be 
to 65535.) 

SL22 (Level 3): Out of memory while parsing the 
parameter. 

REFERENCES 

4110 Series Host Programmers Manual 
SET-SEGMENT-CLASS command 
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SET-DIALOG-AREA-ALTERNATE-INDEX Command 



4112,4113,4115 



Host Syntax 



E cLJ \ntcolor-index 



Setup Syntax 



DA2INDEX s p color-index 



PARAMETERS 

color-index (0 through 32767). 

Specifies the color index you want to represent boldface. 

DESCRIPTION 



DEFAULTS 

color-index 

as shipped — 41 1 2: 5; 41 1 3, 41 1 5: 7 
on power-up — remembered 
if omitted — 



This command specifies the color index to be used for 
characters in "boldface," set by a SELECT-GRAPHIC- 
RENDITION command. 

Even though this command is part of the T41 00 command 
set, it affects the action of a command that is part of the 
ANSI command set. 

If you do not set the color index for boldface characters with 
this command, the color defaults to 5 on q 41 1 2, 7 on a 41 1 3 
or4115. 



ERRORS 

LJ00 (Level 0): Unrecognized command. (Terminal firm- 
ware is not Version 4 or later 41 12,411 3, 
or4115.) 

LJ11 (Level 2): Invalid color-index (must be to 32767). 



REFERENCES 

SELECT-GRAPHIC-RENDITION command 
(ANSI command set) 
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SET-DIALOG-AREA-BUFFER-SIZE Command 



Host Syntax 



E cLB \n\:number-of-lines 



Setup Syntax 



DABUFFER s p number-of-lines 



PARAMETERS 

number-of-lines (2 to 32767). 

The number of full-width lines of text which will fit in the 
dialog area buffer. Here, "full width" means the width 
as set by the most recent SET-DIALOG-AREA-CHARS 
command. 



DESCRIPTION 

This command sets the buffer size for the dialog area. Suf- 
ficient buffer space is reserved and initialized to store 
number-of-lines of dialog text. The width of the lines (maxi- 
mum number of characters permitted in each line) is set by 
int of the SET-DIALOG-AREA-CHARS command. The num- 
ber of lines in the dialog area screen image is set by the 
SET-DIALOG-AREA-LINES command. 

In the 4112,4113, and 41 1 5, the number-of-lines parameter 
in this command must be equal to or greater than the 
number-of-lines parameter in the SET-DIALOG-AREA- 
LINES command. Otherwise, when the dialog area is made 
visible (with a SET-DIALOG-AREA-VISIBILITY command), 
error LV03 is generated, and the size of the dialog area 
buffer is increased to equal the number of lines set by the 
SET-DIALOG-AREA-LINES command. If the buffer size 
cannot be increased (e.g., lack of memory space), the num- 
ber of dialog area lines is decreased to equal the dialog area 
buffer size. 



The value specified in number-of-lines Xakes effect when 
the dialog area is next made visible, even if you change the 
dialog area buffer size while the dialog area is visible. (See 
the SET-DIALOG-AREA-VISIBILITY command.) 

On the 41 1 4 and 4116, more than number-of-lines physical 
lines can appear in the buffer if many of the lines are shorter 
than the width set by the SET-DIALOG-AREA-CHARS 
command. 



DEFAULTS 

number-of-lines 

as shipped — 41 1 2, 41 1 3, 41 1 5: 34; 411 4, 41 1 6: 1 5 
on power-up — remembered 
if omitted — error LB1 1 



ERRORS 

LB1 1 (Level 2): Invalid number-of-lines. (Must range from 
2 to 32767.) 



REFERENCES 

SET-DIALOG-AREA-CHARS command 
SET-DIALOG-AREA-LINES command 
SET-DIALOG-AREA-VISIBILITY command 
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Setup Syntax 



DACHARS s p number-of-chars 



rARAmt. ■ trio 

number-of-chars (41 1 2, 41 1 3: 5 to 80; 41 1 4, 41 1 6: 5 to 81 9; 
4115: 5tO 160) 
Maximum number of characters per line in the dialog 

area. 



Pnr a A"\ 1 R tho mavimum lino lonnth ic a funntirtn r*f rharar. 

ter size as set by the SET-4014-ALPHATEXT-SIZE command, 
if iarge characters are in use, 80 Is the limit for number- 
of-chars. If small characters are in use, the limit is 1 60. 

DEFAULTS 



DESCRIPTION 

Sets the maximum number of characters in a line of the 
dialog area. This value takes effect when the dialog area is 
made visible. See also the SET-DIALOG-AREA-VISIBILITY 
command description. 

The number-of-chars parameter may not be less than five; if 
a number less than five Is specified an error is detected. 

On a 41 1 4 and 41 1 6, when a SET-DIALOG-AREA-CHARS 
command decreases the number of characters allowed on 
each line of the dialog area, previous lines already stored 
in the dialog area are shortened to make them conform 
to the new SET-DIALOG-AREA-CHARS setting when the 
command takes effect. 

Also on a 41 1 4 and 41 1 6, if the size of the dialog area text is 
such that if you make the lines longer the characters will 
extend outside the dialog area, error LV03 is detected. See 
the SET-DIALOG-AREA-VISIBILITY command. 



number-of-chars 

as shipped — 41 12, 41 1 3, 41 1 5: 80; 41 14, 41 1 6: 73 
on power-up — remembered 
if omitted — error LC1 1 

ERRORS 

LC11 (Level 2): Invalid number-of-chars. (4112, 4113: 5 to 
80; 41 14, 4116: 5 to 81 9; 4115: 5 to 160.) 

REFERENCES 

SET-DIALOG-AREA-VISIBILITY command 
ERASE-DIALOG-AREA command 
SET-DIALOG-AREA-BUFFER-SIZE command 
SET-DIALOG-AREA-INDEX command 
SET-DIALOG-AREA-LINES command 
SET-DIALOG-AREA-POSITION command 
SET-DIALOG-AREA-SURFACE command 
SET-DIALOG-AREA-WRITING-MODE command 
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SET-DIALOG-AREA-INDEX Command 



4112,4113,4115 



Host Syntax 



E cLI mV.character-index \n\:char-background-index \n\:wipe-index 



Setup Syntax 



DAINDEX s p character-index char-background-index wipe-index 



PARAMETERS 

character-index (0 to 32767). 

The color index with which characters are displayed in 
the dialog area. 

char-background-index (0 to 32767). 

The color index with which the backgrounds of charac- 
ters are displayed. 

wipe-index (0 to 32767). 

The color index used when erasing the dialog area. 



DESCRIPTION 

This command sets the color indices used in the dialog 
area. The first parameter specifies the color index used to 
write characters; the second parameter specifies the color 
index used to write the backgrounds of those characters; 
and the third parameter specifies the color index used when 
erasing the dialog area. 

There is a maximum color index for the surface on which 
the dialog area is located: one less than 2 M , where M is the 
number of bit planes assigned to that surface. (See the 
description of the SET-SURFACE-DEFINITIONS command 
for more information on assigning bit planes to surfaces.) 



Color indices greater than the maximum are treated as if 
they were equal to that maximum. Surface -1 , the "Super 
Surface" is an exception; it corresponds to all bit planes in 
all defined surfaces. (See Appendix D for details on the 
Super Surface.) 



Example. One way to show the operator the boundaries of 
the dialog area is to make characters typed there appear on 
a light gray background. 

Assume the following: (a) There is only one surface, which 
has three bit planes. That is, color indices can range from 
to 7 on that surface, (b) The background gray level is 
"black" — 0% lightness; thus, pixels written in color index 
("transparent") will appear black, (c) color index 7 is set to 
"100% lightness," and color index 4 to "50% lightness." 

Under those assumptions, you can make the dialog area 
appear on an enhanced background by issuing the follow- 
ing command: 

SET-DIALOG-AREA-INDEX : 7, 4, 4 
= E cLI int:7 int:4 int:4 
= E cLI744 

The command's three parameters (7, 4, and 4) have the 
following effects. Characters are displayed in color index 7 
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(white). The background for each character ceii is color 
index 4 (50% lightness). When the dialog scroll is erased, 
all its pixels are set to color index 4 (50% lightness). 



Wipe-Index. When the dialog area is first made visible (by 
the SET-DIALOG-AREA-VISIBILITY command or the 
DIALOG key), the dialog viewport is wiped. That is, all the 
dialog viewport pixels are set to the current wipe-index — 
the third parameter in the SET-DIALOG-INDEX command. 
Likewise, whenever a new line of the dialog area is created 
(scrolls into view), all that line's pixels are set to the dialog 
wipe index. 41 15 terminals ignore this parameter. Unoccu- 
pied character cells are always colorless and transparent. 



Character-Index, Char-Background-Index. When a char- 
acter is typed into the dialog area, the character is written in 

11 IC I'll I I CI II UlCU^y L/iUfUCtCi -t/KUC^A yil IC IIIOl fJ&t Gl I ICICI II I ll IX? 

SET-DIALOG-INDEX command. The other pixels in that 
character cell are written in the current char-background- 
index. (The second parameter in the command). 



Interaction with SET-DIALOG-WRITING-MODE command. 

How characters are written in the dialog area does not 
depend only on this command; the SET-DIALOG-AREA- 
WRITING-MODE command also has an effect. 



DEFAULTS 

character-index 

as shipped — 41 1 2: 7; 41 1 3, 41 1 5: 1 
on power-up — remembered 
if omitted — 

char-background-index 
as shipped — 
on power-up — remembered 
if omitted — 

wipe-index 

as shipped — 

on power-up — remembered 

if omitted — 



tHHORS 

L!00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113or4115.) 

L1 1 1 (Level 2): Invalid character-index (range is 
to 32767). 

LI21 (Level 2): Invalid character-background-index 
(range is to 32767). 

LI31 (Level 2): Invalid wipe-index (range is to 36767.) 



Errors. Errors generated by this command are not gener- 
ated until the next time the dialog area is made visible. If the 
dialog area is visible when the terminal receives the com- 
mand, the dialog area must be made visible again (either 
with the DIALOG key or with a SET-DIALOG-AREA- 
VISIBILITY command) before errors are generated (or 
before the dialog area indices are changed). 



REFERENCES 

SET-DIALOG-AREA-VISIBILITY command 
ERASE-DIALOG-AREA command 

i_ i-LnnLWU*nni-n-Ourii #-iv>i— wwn n i icti iu 

SET-DIALOG-AREA-WRITING-MODE command 
SET-SURFACE-DEFINITIONS command 
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SET-DIALOG-AREA-LINES Command 



Host Syntax 



E cLL \n\:number-of-lines 



Setup Syntax 




PARAMETERS 

number-of-lines (41 1 2, 41 1 3: 2 to 34; 41 1 4, 41 1 6: 2 to 520; 
41 15: 2 to 64) 
The number of lines which are visible at once in the dia- 
log area. 

DESCRIPTION 



set by the SET-DIALOG-AREA-LINES command. If the 
buffer size cannot be increased (e.g., lack of memory 
space), the number of dialog area lines is decreased to 
equal the dialog area buffer size. 

If the number of lines is changed while the dialog area is 
visible, the dialog area must be made visibile again before 
the change is reflected on the screen. See the SET- 
DIALOG-AREA-VISIBILITY command for details. 



This command sets the maximum number of lines in the 
dialog area viewport. This value takes effect when the dia- 
log area is made visible. 

On the 41 14 and 41 16, because the terminal's refresh capa- 
bility is limited, the total number of characters displayed in 
the dialog area should be no more than about 800. For this 
reason, the product of the maximum line size (set with the 
SET-DIALOG-AREA-CHARS command) and the maximum 
number of lines in view (set with the SET-DIALOG-AREA- 
LINES command) should be no more than about 800. 
Otherwise, the display may flicker. If segments, as well as 
the dialog area, are being displayed in refresh mode, then 
this number should be reduced. 

On the 4112,4113, and 41 1 5, the number-of-lines parame- 
ter in this command must be equal to or less than the 
number-of-lines parameter in the SET-DIALOG-AREA- 
BUFFER-SIZE command. Otherwise, when the dialog area 
is made visible (with a SET-DIALOG-AREA-VISIBILITY 
command), error LV03 is generated, and the size of the 
dialog area buffer is increased to equal the number of lines 



DEFAULTS 

number-of-lines 
as shipped — 5 
on power-up — remembered 
if omitted — error LL1 1 



ERRORS 

LL1 1 (Level 2): Invalid number-of-lines (4112,411 3: 2 to 
34; 41 14, 41 16: 2 to 520; 41 15: 2 to 64.) 

REFERENCES 

DIALOG key 

SET-DIALOG-AREA-BUFFER-SIZE command 
SET-DIALOG-AREA-CHARS command 
SET-DIALOG-AREA-POSITION command 
SET-DIALOG-AREA-VISIBILITY command 
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SET-DIALOG-AREA-POSITION Command 



Host Syntax 



E cLX xy: lower-left-corner 



Setup Syntax 



DAPOSITION s p lower-left-corner 



PARAMETERS 

lower-ieft-corner(X = to 4095, Y = to 4095). 

Specifies the position on the screen of the dialog area's 
lower-left corner. (If the dialog area will not fit on the 
screen, the terminal adjusts this position so that the 
dialog area does fit.) 



DESCRIPTION 

Sets the position of the lower left corner of the dialog area. 
The size of the dialog area, and therefore the upper-right 
corner of the dialog area on the screen, is determined by the 
most recent SET-DIALOG-AREA-LINES, SET-DIALOG- 
AREA-CHARS, and SET-ALPHATEXT-SIZE commands. The 

r\/terfisMt "<s ^KannoH tho novt timp tho tormina! rpppiySS a 

SET-DIALOG-AREA-VISIBILITY : ON command. 

The terminal fits the entire area on the screen. If necessary, 
the dialog area position is moved down or to the left to allow 
this. 

If, when the dialog area is turned on, the position you 
assigned is modified by the SET-DIALOG-AREA-CHARS or 



SET-DIALOG-AREA-LINES command, then error LV03 
is detected. See the discussion of the error in the SET- 
DIALOG-AREA-VISIBILITY command description. 

DEFAULTS 

lower-left-corner 
as shipped — (0,0) 
on power-up — remembered 
if omitted — (0,0) 

ERRORS 

LX1 1 (Level 2): Invalid lower-left-corner (41 1 5 Coordinate 
mode 1 only). 

REFERENCES 

SET-DIALOG-AREA-LINES command 
SET-DIALOG-AREA-CHARS command 
SET-DIALOG-AREA-VISIBILITY command 
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SET-DIALOG-AREA-SURFACE Command 



4112,4113,4115 



Host Syntax 



E cLS ml.surface-number 



Setup Syntax 



DASURFACE s p surface-number 



PARAMETERS 

surface-number (41 1 2: 1 to 3; 41 1 3: 1 to 4; 41 1 5: 1 to 8). 
On 41 1 2 and 4113 terminals, specifies the writing sur- 
face on which the dialog area is to be displayed. On 41 1 5 
terminals, specifies which surface's color-to-index 
mapping the dialog area uses for its color indices. 

DESCRIPTION 

This command specifies, for the 41 1 2 and 41 1 3 terminal, 
the surface onto which the dialog area is written. 

On 41 15 terminals, the dialog area has its own surface, and 
this command doesn't set the surface onto which the dialog 
area is written. For the 41 15, this command specifies which 
surface's color map the dialog area uses to assign its own 
color map. Other aspects of the surface (such as visibility 
and priority) do not affect the appearance of the dialog area. 

This command takes effect the next time the dialog area is 
made visible. 



DEFAULTS 

surface-number 
as shipped — 1 
on power-up — remembered 
if omitted — error LS1 1 



ERRORS 

LSOO (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

LS1 1 (Level 2): Invalid surface-number. (41 1 2: 1 to 3; 
4113:1 to4; 4115: 1 to 8.) 

REFERENCES 

SET-DIALOG-AREA-INDEX command 
SET-DIALOG-AREA-VISIBILITY command 
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SET-DIALOG-AREA-VISIBILITY Command 



Host Syntax 



E cLV mtvisibility-mode 



Setup Syntax 



DAVIS s p visibility-mode 



PARAMETERS 

visibility-mode (0 or 1). 

Specifies whether the dialog area is visible or invisible. 
Setup mode parameters are YES and NO. 

NO; makes the dialog area invisible 

1 YES; makes the dialog area visible. 

DESCRIPTION 

This command makes the dialog area visible or invisible. 



Making the Dialog Area Visible. If the parameter is one, the 
contents of the dialog area scroll come into view. 

The dialog area's size and position on the screen are gov- 
erned by the most recent settings for the following 
commands: 

SET-DIALOG-AREA-BUFFER-SIZE 

SET-DIALOG-AREA-CHARS 

SET-DIALOG-AREA-INDEX 

SET-DIALOG-AREA-LINES 

SET-DIALOG-AREA-POSITION 

SET-DIALOG-AREA-SURFACE 

SET-DIALOG-AREA-WRITING-MODE 

SET-401 4-ALPHATEXT-SIZE 



Also, the n arameters chanced bv these commands do not 
go into effect until the SET-DIALOG-AREA-VISIBILITY com- 
mand makes the dialog area visible, if the dialog area is 
visible when the parameters are changed, the changes 
don't go into effect until the next time the dialog area is 
made visible (either by this command or with the DIALOG 
key on the terminal). 

If the values set by the most recent SET-ALPHATEXT-SIZE, 
SET-DIALOG-AREA-CHARS, SET-DIALOG-AREA-LINES, 
and SET-DIALOG-AREA-POSITION commands are such 
that the dialog viewport will not fit on the screen, then a type 
LV03 error occurs. If the current error threshold is 0, a mes- 
sage is displayed to advise the operator that the settings 
have been changed. So long as the dialog area remains 
visible, the REPORT-TERMINAL-SETTINGS command and 
the Setup mode STATUS command will report the altered 
settings. However, the old settings remain in the terminal's 
battery-powered backup memory. If the dialog area is made 
invisible again, then the REPORT-TERMINAL-SETTINGS 
and STATUS command will report the settings stored in the 
backup memory. 

Whether the dialog area is visible on power-up is deter- 
mined by the current ENABLE-DIALOG-AREA setting. (This 
setting is stored in the battery-powered backup memory.) 
That way, on power-up the dialog area is visible if and only 
if it is enabled. 
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Making the Dialog Area Invisible. If the parameter is zero, 
the dialog area becomes invisible. 

NOTE 

Whether alphatext is directed to the dialog area 
scroll does not depend on that scroll's visibility. 
Even if the dialog area is visible, alphatext may not 
be directed to it; conversely, alphatext may be 
directed to the dialog area even though that area is 
invisible. 

It is the ENABLE-DIALOG-AREA command 
which determines whether alphatext is directed to 
the dialog area. See ENABLE-DIALOG-AREA. 

The action of this command is identical to that caused 
by the DIALOG key from the keyboard {light off = 0; 
light on = 1). 

DEFAULTS 



ERRORS 

LV03 (Level 0): One or more of the dialog area parame- 
ters was altered when the dialog area was 
made visible. 

LV1 1 (Level 2): Invalid visibility-mode. (Must be or 1 ; in 
SETUP mode, must be YES or NO.) 



REFERENCES 

CLEAR-DIALOG-SCROLL command 
DIALOG key 

ENABLE-DIALOG-AREA command 
SET-DIALOG-AREA-BUFFER-SIZE command 
SET-DIALOG-AREA-CHARS command 
SET-DIALOG-AREA-INDEX command 
SET-DIALOG-AREA-LINES command 
SET-DIALOG-AREA-POSITION command 
SET-DIALOG-AREA-SURFACE command 
SET-DIALOG-AREA-WRITING-MODE command 
SET-4014-ALPHATEXT-SIZE command 



visibility-mode 
as shipped — 
on power-up — Same as remembered setting for 

ENABLE-DIALOG-AREA 
if omitted — 1 
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SET-DIALOG-AREA-WRITING-MODE Command 



Host Syntax 



E cLM mX.writing-mode 



Setup Syntax 



DAMODE s p writing-mode 



PARAMETERS 

writing-mode (0 or 1). 

Specifies the writing mode used for text going to the 
dialog area. Setup mode parameters are REPLACE and 
OVERSTRIKE. 





1 



REPLACE 
OVERSTRIKE 



DESCRIPTION 

This command sets the writing mode for dialog area charac- 
ters with respect to characters already present in the dialog 
area. 

If you specify a writing-mode of 1 (Overstrike mode) on a 
41 1 2 or 41 1 3, dialog area characters are written over old 
characters without first erasing the old characters. On the 
4112,4113, and 41 1 5, this mode uses a lot of memory 
(twice the amount used by Replace mode) if you overstrike 
with any character other than a space or an underscore (_). 

If you specify a writing-mode of 1 on a 41 1 5, only space and 
underscore characters are written over old characters; 
other characters act like the terminal is in Replace mode. 

If you specify a writing-mode of (Replace mode), dialog 
area characters completely replace the old characters in a 
given character space. 



Tho terminal ie ehir\r\^H frr\m the* ffar»+nrw iji/itt-i iha Hial/-»n orao 

writing mode set to (replace). In this mode, a character 
typed in the dialog area erases any characters formerly at 
that character position. This mode is useful with the "line 
editing" features of some host operating systems. 

A value of 1 (overstrike) lets you underline characters by 
backspacing and typing over them with the "underscore" 
character, (_). This feature is useful with the APL character 
set, in which many "overstrike" character combinations are 
used. The APL character set is not available on the 41 15. 



DEFAULTS 

writing-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

LM1 1 (Level 2): Invalid writing-mode (must be or 1 ) 

REFERENCES 

SET-DIALOG-AREA-INDEX command 
SET-GRAPHICS-AREA-WRITING-MODE command 
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SET-DMA-BLOCK-SIZE Command 



OPTION 3A 



Host Syntax 




Setup Syntax 




PARAMETERS 

DMA-block-size (1 to 65504). 

Specifies the maximum number of bytes that are trans- 
ferred by DMA in a single block. 



the terminal has more data to send than fits in one block, 
the data is broken into multiple blocks, each of which is 
smaller or equal in size to DMA-block-size. 

DEFAULTS 



DESCRIPTION 

When DMA is the source in a file transfer operation, the 
block size specifies the number of bytes that the terminal 
reserves for a single DMA block. The block the DMA sends 
to the terminal may be smaller than or equal to the DMA- 
block-size. Each block transfer from the DMA is completed 
before the terminal sends the block to the destination. If 
the block is larger than the specified block size, an error is 
detected and the transfer is aborted. 

When DMA is the destination in a file transfer operation, the 
block size specifies the maximum number of bytes that the 
terminal sends to the DMA during a single data transfer. If 



DMA-block-size 
as shipped — none 
on power-up — 51 2 
if omitted — error JH1 1 



ERRORS 



JH00 (Level 0): Unrecognized command; Option 3A is not 
installed. 

JH03 (Level 2): SET-DMA-BLOCK-SIZE command 

received after DMA failed to power up. 

JH11 (Level 2): Invalid DMA-block-size (must be from 
1 to 65504). 
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SET-DRAW-BOUNDARY-MODE Command 



4115 



Host Syntax 



E cUB \nV.draw-boundary-mode 



Setup Syntax 



E cUB draw-boundary-mode 



PAR AM ET ERS 

draw-boundary-mode (0 or 1). 

Specifies whether boundaries of panels defined by the 
DRAW-RECTANGLE command are drawn. 



boundaries are not drawn 
boundaries are drawn 



ERRORS 

UB00 (Level 0): Unrecognized command. (Terminal is not 
a 41 15.) 

UB11 (Level 2): Invalid draw-boundary-mode (must be 
Oorl). 



REFERENCES 



DESCRIPTION 

This command specifies whether the boundaries of rectan- 
gles defined by the DRAW-RECTANGLE command will be 
drawn or not. 



BEGIN-PANEL-BOUNDARY command 
DRAW-RECTANGLE command 



DEFAULTS 

draw-boundary-mode 
as shipped — 
on power-up — 
if omitted — 
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SET-DUPLEX-MODE Command 



OPTION 01 



Host Syntax 



E cOD \n\:duplex-mode 



Setup Syntax 



DUPLEX s p duplex-mode 



PARAMETERS 

duplex-mode (0 to 3). 

Specifies which sort of Duplex mode is active. Setup 
mode parameters are FULL, NORMAL, ARTS, and 
SUPER. 

FULL; full duplex data communications 

protocol 

IKIflRMAI ■ holl Hi inlov nnrmal r\rrstr*r*r\\ 

2 ARTS; half duplex with automatic request 
to send 

3 SUPER; half duplex with supervisor 



DESCRIPTION 

The SET-DUPLEX command allows the host computer to 
set the duplex mode for the terminal's communication with 
the host. An int of zero places the terminal in normal full 
duplex mode. Mode 1 is the normal half duplex mode. Mode 
2 places the terminal in half duplex with an automatic 
request to send. Mode 3 puts the terminal in half duplex 
mode with a supervisor function operating from the host. 

Normally, the terminal's duplex mode is set by the operator, 
using the "setup mode" DUPLEX command; see the appro- 
priate operator's manual for details. However, the SET- 
DUPLEX "escape sequence" command is also provided 
for possible use by the host computer. 



Programming Considerations. This command (like all 
commands) does not take effect until the terminal has proc- 
essed it. After the host sends this command, it should wait 
for the command to be completely processed through the 
terminal's input queue before sending additional data that 
relies on a mode set by the command. After sending the 
SET-DUPLEX command, the host might issue a REPORT- 
TERMINAL-SETTINGS command to inquire the terminal's 
duplex setting. The host would then read the terminal- 
settin°s-re n ort which the terminal returns. !f the terminal 
reports the correct duplex mode, then the host can proceed 
with the rest of its program; otherwise, it can issue another 
REPORT-TERMINAL-SETTINGS command and try again. 

DEFAULTS 

duplex-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

OD00 (Level 2): Unrecognized command. (Option 1 is not 
installed.) 

OD01 (Level 2): Invalid duplex-mode (must be to 3). 
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Setup Syntax 



ECHO s p echo-mode 



DADAMCTCDC 
■ Mi a#-uivii— • ^i *w 

echo-mode (0or1). 

Specifies whether the terminal echos characters typed 
on the keyboard (local echo). Setup mode parameters 
are YES and NO. 

NO; no local echo 

1 YES; local echo of typed characters 

DESCRIPTION 

If echo-mode is 1 , then characters which the operator types 
to the host are echoed locally by the terminal. 

If echo-mode is 0. all local echoing is stopped. 



DEFAULTS 

echo-mode 

as shipped — 

on power-up — remembered 

if omitted — 



ERRORS 

KE11 (Level 2): Invalid echo-mode (must be or 1). 

REFERENCES 

ARM-FOR-BLOCK-MODE command 



NOTE 

If the optional block mode communications proto- 
col is used, then local echo should be enabled. 
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SET-EDIT-CHARS Command 



Host Syntax 



E cKZ mtchar-delete 


mV.line-delete 


ml.take-literally 


Setup Syntax 


EDITCHARS s p 


char-delete 


line-delete take-literally 



PARAMETERS 

char-delete (0 to 127). 

Numeric equivalent of the Setup mode char-delete 
character. 

line-delete (0 to 127). 

Numeric equivalent of the Setup mode line-delete 
character. 

take-literally (0 to 1 27). 

Numeric equivalent of the Setup mode take-literally 
character. 



DESCRIPTION 

The SET-EDIT-CHARS command sets the values of the 
char-delete, line-delete, and take-literally characters which 
the operator can use for line editing while in SETUP mode. 

Specifying N u (ADE 0) for any of these characters causes 
the present value of that character to be left unchanged. 
Specifying c r for any of these is allowed, but c r remains as a 
line terminator, and does not perform editing functions. 



Char-Delete Character. The char-delete character deletes 
the character just typed from the Setup mode command line 
being typed. The cursor backs up one character position, so 
that an operator can retype the character correctly. 



Line-Delete Character. The line-delete-character deletes the 
current Setup mode command line. The terminal displays 
an asterisk to prompt an operator for another Setup mode 
command line. 



Take-Literally Character. The take-literally character allows 
an operator to type special characters as part of a com- 
mand. For instance, the operator may be typing a command 
which takes a delimited sequence of ASCII characters as a 
parameter, and want to include c r as part of that sequence. 
To do this, the operator can type the current take-literally 
character, followed by c r. 

The take-literally character causes the terminal to interpret 
the following character as just another data item. This lets 
the operator enter parameters which include special char- 
acters like c r, the current char-delete character, the current 
line-delete character, or even the current take-literally 
character. 
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DEFAULTS 

char-delete 

as shipped — 127 ( d t) 

on power-up — remembered 

if omitted — unchanged 

line-delete 

as shipped — 24 ( c n) 

on power-up — remembered 

if omitted — unchanged 



ERRORS 

KZ11 (Level 2): Invalid char-delete character (must range 
from to 127). 

KZ21 (Level 2): Invalid line-delete character (must range 
from to 127). 

KZ31 (Level 2): Invalid take-literally character (must 
range from to 1 27). 



REFERENCES 



take-literally 

as shipped — 1 26 ( — ) 

on power-up — remembered 

if omitted — unchanged 



See the description of Setup mode in the Operator's Manual 
for the particular TEKTRONIX 41 1 Series Computer 
Display Terminal. 
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SET-EOF-STRING Command 



Host Syntax 



E cNE M-array.EOF-string 



Setup Syntax 



EOFSTRING s p EOF-string 



PARAMETERS 

EOF-string 

This int-array holds numeric equivalents of up to ten 
ASCII characters, which comprise the EOF-string. Each 
numeric equivalent must be in the range from to 127. 

DESCRIPTION 

This command sets the terminal's EOF-string (end-of-file 
string). 

The EOF-string is used (when the terminal is not in block 
mode) to mark the end of a file being transferred between 
the terminal and the host computer. (In block mode, a bit in 
one of the control bytes at the end of the block serves a 
similar purpose.) 

If the terminal is not in block mode, it appends the current 
EOF-string to the end of each file it sends to the host in 
response to a copy command. When the host is sending a 
file to the terminal, it should append the current EOF-string 
at the end of its transmission. (This lets the terminal know 
when the end of the file has been reached.) 



When the terminal is in block mode, the end-of-file bit in the 
block-control-bytes takes the place of the EOF-string. When 
the terminal is in Block mode, or is armed for Block mode, it 
is incapable of recognizing the EOF-string in data coming 
from the host computer. 

NOTE 

If you will not be using Block mode, do not arm the 
terminal for Block mode. If the terminal is armed 
for Block mode, but is not yet actually in Block 
mode, the only way to terminate a copy from the 
host is with the CANCEL key. 

When not in block mode, the terminal intercepts EOF- 
strings in data coming from the host, and deletes them from 
the incoming data stream. Because of this, it may be pru- 
dent to set the EOF-string to the desired value only just 
before each copy operation, and to set the EOF-string to the 
empty string after the copy. 

Besides the COPY command, the following commands also 
use EOF-strings when sending data to, or receiving data 
from, the host computer: DIRECTORY, LOAD, PLOT, PORT- 
COPY, SAVE, and SPOOL. 
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DEFAULTS REFERENCES 

EOF-string ARM-FOR-BLOCK-MODE command 

as shipped — empty array COPY command 

on power-up — remembered DIRECTORY command 

if omitted — empty array LOAD command 

PLOT command 
PORT-COPY command 

ERRORS SAVE command 

NE11 (Level 2): Invalid EOF-string (must contain from to SPOOL command 
1 characters, with each character repre- 
sented by an int in the range from to 127), 

NE12 (Level 3): Out of memory while parsing the 
parameter. 
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SET-EOL-STRING Command 



Host Syntax 



E cNT ml-array.EOL-string 



Setup Syntax 



EOLSTRING s p 



PARAMETERS 

EOL-String An array of from to 2 ints. Each int is the 
numeric equivalent of an ASCII character, and so must be in 
the range from to 1 27. 

DESCRIPTION 

This command sets the EOL-string (end-of-line string). This 
string is typically the single character, c r; the SET-EOL- 
STRING command lets you set it to other combinations, 
such as, say, c r l f. 

In Block mode, the terminal sends the EOL-string at the end 
of each line it sends to the host. 

When not in Block mode, the EOL-string is sent at the end 
of reports which the terminal sends the host; see the syntax 
description for the particular report type for details. 



ERRORS 

NT1 1 (Level 2): Invalid EOL-string (contents: from to 2 
ints; each in the range from to 1 27). 

NT12 (Level 3): Out of memory while parsing the 
parameter. 



REFERENCES 

ARM-FOR-BLOCK-MODE command 
GIN-locator-report syntactic construct 
GIN-pick-report syntactic construct 
GIN-report-sequence syntactic construct 
GIN-stroke-report syntactic construct 
REPORT-DEVICE-STATUS command 
REPORT-ERRORS command 
REPORT-PORT-STATUS command 
REPORT-SEGMENT-STATUS command 
REPORT-TERMINAL-SETTINGS command 



DEFAULTS 

EOL-string 

as shipped — 1 3 ( c r) 

on power-up — remembered 

if omitted — empty array 
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SET-EOM-CHARS Command 7-249 

SET-ERROR-THRESHOLD Command 7-250 

SET-FIXUP-LEVEL Command 7-251 

SET-FLAGGING-MODE Command 7-253 

SET-GIN-AREA Command 7-255 

SET-GIN-CURSOR Command 7-257 

SET-GIN-DISPLAY-START-POINT Command 7-259 

SET-GIN-GRIDDING Command 7-260 

SET-GIN-INKING Command 7-262 

SET-GIN-RUBBERBANDING Command 7-264 

SET-GIN-STROKE-FILTERING Command 7-266 

SET-GIN-WINDOW Command 7-268 

SET-GRAPHICS-AREA-WRITING-MODE Command 7-269 

SET-GRAPHTEXT-FONT Command 7-270 

SET-GRAPHTEXT-FONT-GRID Command 7-272 

SET-GRAPHTEXT-PRECISION Command 7-274 

SET-GRAPHTEXT-ROTATION Command 7-275 

SET-GRAPHTEXT-SIZE Command 7-276 

SET-GRAPHTEXT-SLANT Command 7-277 

SET-IMAGE-ORIENTATION Command 7-278 

SET-KEY-EXECUTE-CHARACTER Command 7-280 

SET-LINE-INDEX Command 7-281 

SET-LINE-STYLE Command 7-282 

SET-LINE-WIDTH Command 7-283 

SET-MARGINS Command 7-284 

SET-MARKER-TYPE Command 7-286 

SET-NUMBER-OF-COPIES Command 7-288 

SET-OVERVIEW-WINDOW Command 7-289 

SET-PAGE-FULL-ACTION Command 7-291 
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Host Syntax 



E cNC M:EOM-char-l \r\X:EOM-char-2 



Setup Syntax 



EOMCHARS s p EOM-char-l EOM-char-2 



TERS 

EOM-char-l (0 to 1 27). 

Numeric equivalent of an EOM-char: an ASCII character 
that marks the end of a line of text in data sent to the host 
computer. means "no character". 

EOM-char-2 (0 to 127). 

Numeric equivalent of another EOM-char. (If only one 
EOM-char is desired, set one of the two parameters in 
the SET-EOM-CHARS command to 0. If no EOM-chars 
are desired, set both parameters to 0.) 

DESCRIPTION 



around", or EOM-(end-of-message) characters. 

The ASCII N u character (whose numeric equivalent is zero) 
may not be used as an EOM-character. You can specify any 
other ASCII character as an EOM-character by including its 
numeric equivalent as one of the two parameters in this 
command. To specify only one EOM-character, give its 
numeric equivalent in one of the parameters, and set the 
other parameter to 0. To designate no EOM-characters, set 
both parameters to zero. 

See the 4110 Series Host Programmers Manual for a 
description of the effects of EOM-chars. 



DEFAULTS 

EOM-char-l 

as shipped — 13 ( c r) 

on power-up — remembered 

if omitted — 

EOM-char-2 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

NC1 1 (Level 2): Invalid EOM-char-l. (Must range from 
to 127.) 

NC21 (Level 2): Invalid EOM-char-2. (Must range from 
to 127.) 



REFERENCES 

4110 Series Host Programmers Manual 
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SET-ERROR-THRESHOLD Command 



Host Syntax 



E cKT mkerror-threshold-level 



Setup Syntax 



ERRORLEVEL s p error-threshold-level 



PARAMETERS 

error-threshold-level (0 to 4). 

The minimum error severity for an error message to be 
displayed. causes all errors to be displayed, while 4 
suppresses all error messages. 



DEFAULTS 

error-threshold-level 
as shipped — 2 
on power-up — 2 
if omitted — 



DESCRIPTION 

Sets the minimum severity level for errors whose messages 
are to be displayed. 

Errors are always recorded in the terminal's error queue, 
and the report may be obtained with the REPORT-ERRORS 
command. 



ERRORS 

KT1 1 (Level 2): Invalid error-threshold-level (must range 
from to 4). 

REFERENCES 

REPORT-ERRORS command 
Appendix C, Error Codes 
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SET-FIXUP-LEVEL Command 



4112,4113,4115 



Host Syntax 



E cRF \ntfixup-level 



Setup Syntax 



FIXUP s p fixup-level 



PARAMETERS 

fixup-level (-32767 to 32767). 

A number specifying how frequently the terminal 
updates the current viewport in its display. 

DESCRIPTION 

This command controls the amount of time spent updating 
the current viewport on the terminal when changes are 
made that affect the current view. Although this could be 
done with every change, this might be a time-consuming 
task for complex views. The higher the fixup-level, the more 
effort will be spent updating the viewport. A complete 
update occurs on a RENEW-VIEW command, a PAGE com- 
mand, or a depression of the PAGE key. 

Table 7-22 lists the fixup-levels and their meanings. A posi- 
tive fixup-level not listed in the table has the same effect as 
the next iower fixup-level which is listed. For instance, 
fixup-levelZ has the same effect as fixup-level 2; fixup-level 
100 has the same effect as fixup-level 6. A negative/k^p- 
level causes the fixup-level lo be set to 0, and error RF1 1 
(Level 1) to be generated. 

The default fixup-level is six. 



Fixup 
Level 



Table 7-22 
FIXUP LEVELS 



Meaning 



i he screen is updated on a RENEW-VIEW or PAGE 
command, or when the PAGE or VIEW key is pressed. 

(At fixup level 0, these are the only times the viewport 
contents are altered.) 



the action listed above for fixup level is performed. 
Besides this, the display is updated to show any 
additions to the current view, as those additions are 
made. (For instance, whenever a line is drawn in the 
current view, the display is updated to show that line. 
Also, whenever a segment is made visible, the display 
is updated to show that segment.) 

(At fixup level 2, when a segment is moved, it is drawn 
in the new position, but not erased from its old position. 
The display is not updated when a segment is made 
invisible or deleted.) 



The actions listed above for fixup levels and two are 
performed. In addition, segments displayed in XOR 
mode are erased (by drawing them again in XOR mode) 
in response to commands that change the segment's 
visiblity or position in terminal space. 

Segments displayed in Set mode are treated as in fixup 
level two. 



The actions described aboved for fixup levels through 
4 are performed. In addition, whenever a segment is 
made invisible or is deleted, that segment is erased 
from the viewport. (For segments drawn in Set mode, 
this is done by redrawing the segment in the current 
wipe index. For segments drawn in XOR mode, this is 
done by redrawing the segment in XOR mode.) 
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DEFAULTS REFERENCES 

fixup-level SET-SEGMENT-WRITING-MODE command 

as shipped — 6 SET-SEGMENT-VISIBILITY command 

on power-up — 6 
if omitted — 

ERRORS 

RFOO (Level 0): Unrecognized command. (The terminal is 
nota4112, 4113, or4115.) 

RF1 1 (Level 1 ): The fixup-level is less than zero. 

RF1 1 (Level 2): \m&M fixup-level (must be -32767 to 
3276/). 
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Host Syntax 



E cNF m\:flagging-mode 



Setup Syntax 



FLAGGING s p flagging-mode 



PARAMETERS 



DESCRIPTION 



flagging-mode (0 to 4). 

Specifies whether flagging occurs between the terminal 
and the host, and if flagging occurs, what type. Setup 
mode parameters are NONE, INPUT, OUTPUT, IN/OUT, 
and DTR/CTS. 

NONE; no flagging 

1 INPUT; DC1/DC3 flagging when receiving 
data from the host 

2 OUTPUT; DC1 /DC3 flagging when transmit- 
ting to the host 

3 IN/OUT; DC1/DC3 flagging both when trans- 
mitting and when receiving 

4 DTR/CTS; flagging with the data terminal 
ready and clear to send RS-232 signal lines. 



This command sets the "flagging," or "handshaking," 
protocol between the terminal and its host computer. (The 
SET-PORT-FLAGGING-MODE command controls similar 
protocols between the terminal and its RS-232 peripheral 
devices.) 



Mode (No Flagging). DC1/DC3 and DTR/CTS flagging 
are both disabled. 



NOTE 

When DC1/DC3 flagging (modes 1, 2, and 3) is 
enabled, the terminals and host's flag recognition 

ffic^fiutiioifi uuoOfu inc. t unu. j u/iu/uttc/j, 



Mode 1 (INPUT), the terminal uses the "DC1/DC3" flagging 
protocol when receiving characters from the host. If the host 
is sending characters to the terminal faster than the termi- 
nal can process them, so that the terminal's input buffer is 
in danger of overflowing, then the terminal sends the host a 
D 3 character. The host is then expected to suspend trans- 
mission of characters to the terminal. When the terminal is 
ready for more characters, it sends the host a D i . The host is 
then expected to resume transmission of characters to the 
terminal. 
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Mode 2 (OUTPUT). The terminal uses the "DC1/DC3" 
flagging protocol when transmitting characters to the host. 
The host can send the terminal a D 3 when its input buffer is 
in danger of overflowing. The terminal sends at most 1 or 2 
more characters, and then stops transmitting to the host. 
When it receives a D i , the terminal resumes its transmission 
to the host. 



Mode 3 (IN/OUT). The terminal uses the "DC1/DC3" flag- 
ging protocol both when receiving characters from the host 
and when transmitting characters to the host. 



Mode 4 (DTR/CTS). In DTR/CTS flagging, two signal lines 
ai the RS-232 connector are used to reguiate the flow of 
data between the terminal and the host computer. These 
lines are DTR (data terminal ready) and CTS (clear to send). 



If DTR/CTS flagging is enabled, the terminal uses the DTR 
(data terminal ready) signal line in the same way that the 
host uses the CTS line. If the host is sending characters 
faster than the terminal can process them, so that the termi- 
nal's input buffer is in danger of overflowing, then the termi- 
nal drops DTR (places a negative voltage on the DTR signal 
line). The host is then expected to stop transmitting to the 
terminal. When the terminal is ready for more characters, it 
asserts DTR (places a positive voltage on the DTR line), and 
the host resumes its transmission to the terminal. 



DEFAULTS 



flagging-mode 
as shipped — 
on power-up — remembered 
if omitted — 



NOTE 

DTR /CTS flagging is usually not practical when 
the host is connected to the terminal over telephone 
lines by the use of modems. (In such a circum- 
stance, the host does not have direct access to the 
DTR and CTS signal lines.) This flagging mode is 
only practical if the host is connected directly to the 
terminal. 



The terminal indicates that it wishes to transmit data by 
asserting DTR (placing a positive voltage on the DTR signal 
line). If the host is ready to receive the data, it asserts CTS. 
The terminal is only allowed to transmit when CTS is 
asserted. Should the terminal be transmitting characters 
faster than the host can process them, so that the host's 
input buffer is in danger of overflowing, the host can drop 
CTS (place a negative voltage on the CTS signal line). With 
CTS negative, the terminal automatically stops transmitting. 
When the host is ready to receive more characters, it 
asserts CTS again, and the terminal resumes its 
transmission. 



ERRORS 

NF11 (Level 2): Invalid flagging-mode (must range 
from to 4). 



REFERENCES 

SET-BLOCK-NON-XMT-CHARS command 
SET-PORT-FLAGGING-MODE command 
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SET-GIN-AREA Command 



Host Syntax 



E clV \r\\:device-function mtwindow-type xy.first-corner xy.second-corner 



Setup Syntax 



GINAREA s p device-function window-type first-corner second-corner 



vit: i trio 



aevice-junciion 

The GIN device-function you want. See the ENABLE-GIN 
command for details. 



nFcrmpTiruM 

^r^X4"Wt ••• • IW11 

This command maps a specified rectangular region on a 
GIN device (a GIN area) onto a specified rectangular win- 
dow in terminal coordinate space. 



window-type (-1 to 64). 

The type of window you are specifying. 

-1 the window set by the SET-GIN-WINDOW 

command 

the window of the current view 

1 to 64 the window of view 1 to 64, respectively 

(41 15 only) 

first-corner (X = to 4095, Y = to 4095). 

The first corner of the area you are specifying on the 
specified GIN device. 

second-corner (X = to 4095, Y = to 4095). 

The second corner of the area you are specifying on the 
specified GIN device. 



Device-Function. When you assign a GIN area to a device- 
function, the GIN area is assigned to all functions of the 
specified device. For example, if you assign a GIN area to 
the tablet-locator device-function, and then invoke the tab- 
let-pick device-function, the same GIN area is used. 



Window-type. If you specify a window-type of -1 , the GIN 
device area (specified by the third and fourth parameters) is 
mapped into the terminal space region specified by the 
most recent SET-GIN-WINDOW command. The specified 
GIN device area remains mapped into the specified terminal 
space window until another SET-GIN-AREA command 
remaps it by enclosing the former device area within its 
own. 

On a 41 1 2, 41 1 3, or 41 1 5, if you specify a window-type of 0, 
the GIN device area is mapped into the window of the cur- 
rent view each time the device is enabled and a point within 
the GIN area is selected. This window changes when you 
change views. The window also changes when an operator 
does a Zoom or Pan operation. 

Also on a 41 1 2, 41 1 3, and 41 1 5, if you specify a window- 
type of 1 through 64, the GIN area is mapped into the win- 
dow associated with the view of that number. If you specify 
the number of a view that is not defined, then when the 
device-function is invoked, it acts as though there has not 
been a GIN area defined. 
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If the current view is different from the view specified by this 
parameter, the specified view is used for GIN action. Once 
the specified device-function stops its GIN action, the pre- 
vious current view (the one in effect before the GIN action) 
is again the current view. 

On a 41 1 4 and 4116, since there are no views, if you specify 
a window-type of through 64, the window used is always 
from (0,0) to (4095,4095). 

Coordinates. This command assumes that the GIN device 
is 4096-by-4096 units square. If the device is rectangular, 
the command assigns 4096 units to the long axis of the 
device, and an proportionate number of units to the short 



The x- and y-coordinates you assign are sorted so that any 
two corners specify the rectangle. 

If you specify the two x-coordinates the same or the two y- 
coordinates the same (if the GIN area is zero in either direc- 
tion) then an error is generated, except when you specify 
both corners to be (0,0), in which case, the GIN area 
defaults to from (0,0) to (4095,4095). 

You can define multiple GIN areas for tablet and plotter 
devices, but only one for thumbwheels. If the device speci- 
fied in the device-function parameter is the terminal 
thumbwheels, the GIN area must be from (0,0) to 
(4095,4095). If you define overlapping areas on non- 
thumbwheel devices, and the device position is inside more 
than one GIN area, the most recently defined GIN area and 
window-type values are used. 

GIN coordinate data for the device is mapped from the GIN 
area on the associated window. If the window is that of the 
current view (window-type = 0), the movement rate 
remains in proper scale to the window, regardless of the 
zoom scale factor. 

To delete a GIN area, define a GIN area which totally covers 
the GIN area you want to delete. To delete all GIN areas, 
define both the GIN window and the GIN area to be from 
(0,0) to (4095,4095). 



DEFAULTS 

device-function 

as shipped — none 
on power-up — none 
if omitted — 

window-type 

as shipped 1 

on power-up 1 

if omitted 1 

first-corner 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 

second-corner 

as shipped — (4095,4095) 
on power-up — (4095,4095) 
if omitted — (4095,4095) 



ERRORS 

IV00 (Level 0): 

IV03 (Level 3): 

IV11 (Level 2): 

IV21 (Level 2): 

IV31 (Level 2): 



Unrecognized command; terminal firm- 
ware is Version 3 or earlier. 

Out of memory while processing 
command. 

Invalid device-function (see ENABLE- 
GIN). 

Invalid window-specifier (range is -1 
to 64). 

\nva\\d first-corner (41 12, 41 13, 41 14, 
4116:X = to 4095, Y = to 4095; 
41 15: X = -2 31 to 2 31 -1 , Y = -2 31 to 
2 31 -1.) 

IV41 (Level 2): Invalid second-corner or zero width or 
height GIN area (range is 41 1 2, 41 1 3, 
4114, 4116: X = 0to4095,Y = Oto 
4095; 41 15: X = -2 31 to 2 31 -1, Y = -2 31 
to2 31 -1.) 



REFERENCES 

ENABLE-GIN command 
SET-GIN-WINDOW command 
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Host Syntax 



TEK COMMANDS 




Setup Syntax 



GINCURSOR s p device-function segment-number 



KAHAMfc I fcHS 

device-function . 

A graphic input device-function code. (See ENABLE-GIN 
command for details.) 

segment-number (0 to 32767). 

The number of the segment which is to be used as a 
graphic cursor. Segment is the crosshair cursor. 

DESCRIPTION 

This command specifies which segment is to be used as the 
graphics cursor for all subsequent GIN operations, using 
the specified GIN device-function combination. No action is 
seen when this command is given; the result will be seen 
later, when an ENABLE-GIN command is issued for the 
specified device-function combination. 

When a segment is used as the GIN cursor, the segment's 
position is the point reported when a GIN event occurs. 

The cursors selected for the device-functions 0, 8, and 1 
(thumbwheel-locate, tablet-locate, and tablet-stroke) are 
also used for4010-GIN and 4953-GIN. 



ment attributes of this segment are changed as follows: 

• Writing mode is set to refresh mode on a 41 1 4 or 41 1 6, or 
to XOR mode on a 41 1 2, 41 1 3, or 41 1 5. 

• Detectability is turned off. 

• Visibility is turned on. 

As the enabled device is manipulated, the cursor segment's 
position is continuously updated. When a GIN event occurs, 
the cursor position is sent to the host as part of the GIN 
report for that event. 

Once GIN is enabled, you can change the cursor's writing 
mode, detectability and visibility with the appropriate com- 
mands, However, when the device is disabled, the Writing 
mode, detectability, and visibility attributes are restored to 
the values they had when the device was enabled. The 
segment's position attribute, however, is not restored. 



Default. If no SET-GIN-CURSOR command has been 
issued, then "segment 0" — the standard crosshair cursor 
— serves as the GIN cursor. 

Several device-functions can have the same cursor 
assigned at the same time. The position of the cursor is 
determined by the last device to change position. Each 
device maintains its own "GIN-position" which is unaffected 
by other devices, so that a shared cursor segment flickers 
back and forth between the devices' GIN-positions as the 
devices are operated. 
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If the specified segment does not exist, or if this command 
is issued while the specified function is enabled, an error 
occurs. 

In the 41 1 2, 41 1 3, or 41 1 5, the cursor is scaled according to 
the current view transform and image transform. The cursor 
cannot be moved outside of the current viewport. If a 
another view is selected as the current view, the cursor 
moves to that view's viewport and is scaled to reflect the 
new view's window-viewport transform. However, the 
default crosshair cursor, unlike other segments, is not 
clipped at the viewport boundary. 

If the cursor is the default cursor (segment 0, the crosshair 
cursor), its position may be set with the SET-SEGMENT- 
POSITION command. In the 41 1 2, 41 1 3, and 4115, the 
default cursor cannot be positioned outside the window for 
the current view. The terminal will position it as close to the 
specified point as possible, constraining it to be within the 
current window. 

A cursor segment's position may be set using either the 
SET-SEGMENT-POSITION command or the SET-SEG- 
MENT-IMAGE-TRANSFORM command. However, any 
graphic input device motion will restore the cursor back to 
its position prior to the SET-SEGMENT-POSITION or SET- 
SEGMENT-IMAGE-TRANSFORM command. It will then 
move from that point in response to the graphic input 
device. This device may not, by itself, move the cursor out- 
side the window. In the 41 1 2, 41 1 3, and 41 1 5, if the non- 
default cursor is set outside the current window, it ceases to 
be visible in the current viewport. 



DEFAULTS 

device-function 
as shipped — none 
on power-up — none 
if omitted — 

segment-number 
as shipped — 
on power-up — 
if omitted — 



ERRORS 



IC13 (Level 2): Graphic input has already been enabled 
for the specified device-function code. 

IC20 (Level 2): Segment does not exist, or is currently 
being defined. 

IC21 (Level 2): Invalid segment-number (must range 
to 32767). 

REFERENCES 

ENABLE-GIN command 
SET-PIVOT-POINT command 
SET-SEGMENT-DETECTABILITY command 
SET-SEGMENT-VISIBILITY command 

SET-SEGMENT-WRITING-MODE command 
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SET-GIN-DISPLAY-START-POINT Command 



Host Syntax 




Setup Syntax 



GINSTARTPOINT s p device-function start-point 



DA D A MCTCDC 

device-function 

The GIN device and function you want. See the 
ENABLE-GIN command for details. 

start-point 

The point at which GIN-inking and GIN-rubberbanding 
will start. 



DESCRIPTION 

This command sets the start-point that is used by the SET- 
GIN-RUBBERBANDING and SET-GIN-INKING commands 
when they are enabled with a parameter of 2. 



DEFAULTS 



ERRORS 

1X00 (LeveiO): Invalid command; firmware is Version 3 or 
earlier. 

1X1 1 (Level 2): Invalid device-function parameter. (See 
ENABLE-GIN for a table of valid device- 
function codes.) 

1X21 (Level 2): Invalid start-/?o/'/z? (41 12, 4113, 4114, 
41 1 6: X = to 4095, Y = to 4095; 
41 15: X = -2 31 to 2 31 -1 , Y = -2 31 to 
2 31 -1). 



REFERENCES 

ENABLE-GIN command 
SET-GIN-INKING command 
SET-GIN-RUBBERBANDING command 



device-function 
as shipped — none 
on power-up — none 
if omitted — 

start-point 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 
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SET-GIN-GRIDDING Command 



Host Syntax 




Setup Syntax 



GINGRIDDING s p device-function x-grid-spacing y-grid-spacing 



PARAMETERS 

device-function . 

A graphic input device-function code. (See ENABLE-GIN 
command for details.) 

x-grid-spacing (41 1 2, 41 1 3, 41 1 4, 41 1 6: to 4095; 4115:0 
to2 31 -1). 
Horizontal (x-direction) grid spacing. 

y-grid-spacing (41 1 2, 41 1 3, 41 1 4, 41 1 6: to 4095; 4115:0 
to2 31 -1). 
Vertical (y-direction) grid spacing. 

DESCRIPTION 

Causes application of gridding to all subsequent operations 
of the specified locator or pick functions. The x,y parame- 
ters specify an invisible grid that covers the entire terminal 
space. All further graphic cursor movement is constrained 
so that the cursor will always lie on points corresponding to 
the intersections of these grid lines. 



A grid spacing of one serves no useful purpose, since points 
cannot be closer together than one terminal space unit. (It 
would be better to specify a spacing of zero, and thus save 
some time by disabling gridding.) Note also that large grid 
spacings are impractical. X- and y-spacings of 4095 (or 2 31 - 
1 on a 41 1 5 in Coordinate mode 1 ) would permit only four 
(five on a 41 15) accessible points, at the four corners of 
terminal space. 

Gridding applies only to the locator and pick functions; 
gridding is not permitted for the stroke function. 

Default is no gridding (x- and y-spacing both zero). 

For purposes of gridding, an ENABLE-401 0-GIN command 
is considered to be an ENABLE-GIN command for device- 
function code 0. That is, a SET-GIN-GRIDDING command 
for device-function (thumbwheels device, locator function) 
affects graphic input in response to an ENABLE-401 0-GIN 
command as well as graphic input in response to an 
ENABLE-GIN command for device-function zero. 



An x-spacing (or y-spacing) of zero disables gridding in the 
x-direction (y-direction). Specifying zero for both these 
parameters turns off the gridding feature. 
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DEFAULTS 



ERRORS 



device-function 
as shipped — none 
on power-up — none 
if omitted — 

x-grid-spacing 
as shipped — 
on power-up — 
if omitted — 

y-grid-spacing 
as shipped — 
on power-up — 
if omitted — 



101 1 (Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 

IG10 (Level 2): Gridding does not apply to the specified 
device-function code. (Gridding is not 
allowed for the stroke function.) 

IG21 (Level 2): Invalid x-grid-spacing (4112,4113,4114, 
4116:0 to 4095; 41 1 5: to 2 31 -1 ). 

IG31 (Level 2): Invalid y-grid-spacing (41 12, 41 13, 4114, 
4116:0to4095;4115:0to2 31 -1). 



REFERENCES 

ENABLE-4010-GIN command 
ENABLE-GIN command 
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SET-GIN-INKING Command 



Host Syntax 



E cll mtdevice-function mtinking-mode 



Setup Syntax 



GININKING s p device-function inking-mode 



PARAMETERS 

device-function 

See ENABLE-GIN command for details 

inking-mode (0, 1 , or 2). 

Specifies whether Inking mode is on or off, and if on, 
when it starts inking. 

turn inking off 

1 turn inking on 

2 turn inking on (start from GIN-Display-Start- 
Point) 



On 41 14 and 41 1 6 terminals, the line is drawn in storage 
mode, using the current line style and line width. On 41 1 2, 
4113, and 41 1 5 terminals the line is drawn in Set mode 
using the current line style and line index. 

If inking-mode is 2, the first GIN point is "inked" from the 
GIN-display-start-point, set by the SET-GIN-DISPLAY- 
START-POINT command. After the first point, it is identical 
to inking-mode = 1 . 

If inking-mode is 1 , and rubberbanding-mode is set to 2 by 
the SET-RUBBERBANDING-MODE command, then GIN 
inking behaves as if inking-mode was set to 2. 



DESCRIPTION 

This command turns inking on or off for all subsequent 
operation of the specified locator or stroke function (inking 
is not allowed for the pick function). 

When inking is turned on, each locator event after the first 
causes a line to be drawn to the point selected by the loca- 
tor event. During stroke functions, a line is drawn between 
each point in the stroke. 



DEFAULT 

device-function 

as shipped — none 
on power-up — none 
if omitted — 

inking-mode 
as shipped — 
on power-up — 
if omitted — 
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ERRORS 



REFERENCES 



1002 (Level 2): Insufficient memory available for GIN 
functions. 

101 1 (Level 2): Invalid device-function code. (See the 
description of the enable-GIN command 
for a table of device-function codes.) 

1111 (Level 2): Inking does not apply to the specified 
device-function code. (Inking is not 
allowed for the pick function.) 



ENABLE-GIN command 
SET-GIN-DISPLAY-START-POINT command 
SET-GIN-RUBBERBANDING command 
SET-LINE-INDEX command 
SET-LINE-STYLE command 
SET-LINE-WIDTH command 



or 1 if firmware is Version 3 or earlier). 
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SET-GIN-RUBBERBANDING Command 



Host Syntax 



E clR \n\:device-function \vX\rubberbanding-mode 



Setup Syntax 



GINRUBBERBAND s p device-function rubberbanding-mode 



PARAMETERS 

device-function 

See ENABLE-GIN command for details. 

rubberbanding-mode (0, 1 , or 2) 

Specifies whether Rubberbanding mode is on or off, and 
if on, when it starts. 

turn rubberbanding off 

1 turn rubberbading on 

2 turn rubberbanding on (start at GIN-display- 
start-point) 



If rubberbanding-mode is 2, the first GIN point is "rubber- 
banded" from the GIN-display-start-point, set by the SET- 
GIN-DISPLAY-START-POINT command. After the first point, 
it is identical to rubberbanding-mode = 1 . 

If inking-mode, as set by the SET-INKING-MODE command, 
is 1 , and rubberbanding-mode is 2, then GIN inking behaves 
as if inking-mode was set to 2. 

If rubberbanding is turned on or off while the GIN device is 
enabled, only subsequent points are affected. 

The beam position is not affected by the Rubberbanding 
mode. 



DESCRIPTION 

This command turns rubberbanding on or off for all subse- 
quent operations of the specified locator function. Rubber- 
banding is not allowed for the pick and stroke functions. 

With rubberbanding turned on and the specified device- 
function enabled, a line is drawn from the most recently 
selected point to the current cursor position. On 41 1 2, 41 1 3, 
and 41 1 5 terminals, the line is drawn in XOR mode, using 
the current line style and line index. On 41 14 and 41 1 6 
terminals, the line is drawn in refresh mode, using the cur- 
rent line style and line width. If dashed lines are used, the 
pattern of dashes begins at the fixed end of the line. 



DEFAULT 

device-function 
as shipped — none 
on power-up — none 
if omitted — 

rubberbanding-mode 
as shipped — 
on power-up — 
if omitted — 
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ERRORS REFERENCES 

1011 (Level 2): \rwa\\d device-function parameter. (See ENABLE-GIN command 

the table in the ENABLE-GIN description SET-GIN-DiSPLAY-START-POINT command 

for details.) SET-GIN-INKING command 

,,-,.„ „ lm o uu u , ^ . , , . SET-LINE-INDEX command 

IR10 (Level 2): Rubberbanding does not apply to the ___,,.,_ _ w . _ . 

v ' .-...., .. I, io ww SET-LINE-STYLE command 

specified device-function code. (Rubber- ^__ I _ ..„„. . 

. K .. . , „ .. ., . . SET-LINE-WIDTH command 

banding is only allowed for the locator 

function. It is forbidden for the pick and 
stroke functions.) 

IR21 (Level 2): Invalid rubberbanding-mode (must be 0, 
1 , or 2; or 1 if firmware is Version 3 or 
earlier). 
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SET-GIN-STROKE-FILTERING Command 



Host Syntax 




Setup Syntax 



TBFILTER s p device-function distance-filter time-filter 



PARAMETERS 

device-function 

A graphic input device-function code. (See ENABLE-GIN 
command for details.) 

distance-filter (0 to 4095). 

Minimum change in to 4095 GIN device x-coordinate or 
y-coordinate in order for the terminal to send another 
GIN-stroke-report to the host computer. A value of 
disables the distance filter. 

time-filter (0 to 32767). 

Minimum time in milliseconds between stroke events. A 
value of disables the time filter. 



DESCRIPTION 

The specified stroke filtering parameters are applied to all 
subsequent operations of the specified stroke function. 



Device-Function, The device-function code specifies the 
GIN device (which must be the tablet) and the GIN function 
(which must be stroke function). See the description of the 
ENABLE-GIN command for details. 



Distance-Filter. The distance-filter parameter specifies the 
minimum distance the tablet pen or cursor must move in 
either x- or y-direction before a new point is output. This 
distance is expressed in to 4095 GIN device coordinates; 
if either coordinate changes by more than this distance, 
then the terminal will send a new GIN-stroke-report to the 
host. 



Time-Filter. The time-filter parameter specifies the mini- 
mum time in milliseconds that will elapse between succes- 
sive points. As the operator moves the tablet pen or 
four-button cursor, GIN-stroke-reports are sent to the host 
only at intervals of "time" milliseconds. 

The terminal measures time in increments of about 25 milli- 
seconds. Thus, specifying a time of 10 ms is, for practical 
purposes, the same as specifying a time of zero. Again, for 
pratical purposes, 27 ms is the same as 25 ms. 

If both the distance-filter and time-filter parameters are non- 
zero, then all criteria of both parameters must be met for an 
stroke report to be sent to the host. 

When stroke filtering is first enabled (or when the tablet 
stylus or cursor is lifted away from the tablet), the filters are 
reset so that at the first pen contact, a point is returned. 
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Note that if either the distance or the time parameter is zero, 
then that type of filtering is absent. With no filtering, points 
are output at the maximum speed of the tablet interface. 

Filtering does not affect the cursor movement, but does 
affect the image formed by inking: inking occurs only 
between those points whose coordinates are reported to the 
host. 

Locator and pick functions are not affected. Default is no 
filtering. 

DEFAULTS 



ERRORS 

101 1 (Level 2): Invalid device-function. (See ENABLE- 
GIN.) 

IFOO (Level 0): Unrecognized command (tablet option 
not installed). 

IF1 (Level 2): Stroke filtering not valid for specified 
device-function. 

IF21 (Level 2): Invalid distance-filter (range is from 
to 4095). 

IF31 (Level 2): Invalid time-filter (range is from 
to 32767). 



device-function 

as shipped — none 
on power-up — none 
if omitted — error IFiO 

distance-filter 
as shipped — 
on power-up — 
if omitted — 

time-filter 

as shipped — 
on power-up — 
if omitted — 



REFERENCES 



GIN-stroke-report syntactic construct 
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SET-GIN-WINDOW Command 



Host Syntax 



E clW xy.first-corner xy.second-corner 



Setup Syntax 



GINWINDOW s p first-corner second-corner 



PARAMETERS 



DEFAULT 



first-corner (41 1 2, 41 1 3, 41 1 4, 41 1 5: X = to 4095, Y = 
to 4095; 41 15: X = -2 31 to 2 31 -1 , Y = -2 31 to 
2 31 -1). 

A corner of the window in terminal space into which a 

GIN device area is mapped. 

second-corner (41 1 2, 41 1 3, 41 1 4, 41 1 5: X = to 4095, Y 
= to 4095; 41 1 5: X = -2 31 to 2 31 -1 , 
Y = -2 31 to2 31 -1). 
Another corner of the window in terminal space into 
which a GIN device area is mapped. 

DESCRIPTION 

This command sets a window in terminal space which can 
be used by the SET-GIN-AREA command. If SET-GIN-AREA 
specifies a window-type of -1 , then the GIN area also speci- 
fied by that command is mapped into the window in terminal 
space specified by the latest SET-GIN-WINDOW command. 

The x- and y-coordinates you assign are sorted so that any 
two corners specify the rectangle. 



first-corner 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 

second-corner 

as shipped — (4095,4095) 
on power-up — (4095,4095) 
if omitted — (0,0) 

ERRORS 

IW00 (Level 0): Unrecognized command; firmware is 
Version 3 or eariler. 

IW11 (Level 2): \rviay\6 first-corner. (4112, 4113, 4114, 
41 1 6: X = to 4095, Y = to 4095; 
41 1 5: X = -2 31 to 2 31 -1 , Y = -2 31 to 
2 31 -1.) 

IW21 (Level 2): Invalid second-corner. (4112, 4113, 4114, 
41 1 6: X = to 4095, Y = to 4095; 
4115: X = -2 31 to2 31 -1,Y = -2 31 to 
2 31 -1.) 



REFERENCES 

SET-GIN-AREA command 
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SET-GRAPHICS-AREA-WRITING-MODE Command 



4112,4113,4115 



Host Syntax 



E cMG mV.writing-mode 



Setup Syntax 



GAMODE s p writing-mode 



PARAMETERS 

writing-mode (0 or i ). 

Specifes the Writing mode for the graphics area. Setup 
mode parameters are REPLACE and OVERSTRIKE. 

REPLACE 

1 OVERSTRIKE 



DESCRIPTION 

This command sets the writing mode for alphatext which is 
not displayed in the dialog area. (The SET-DIALOG-AREA- 
WRITING-MODE command determines the writing mode 
for dialog area text.) 

The GRAPHICS-AREA-WRITING-MODE command deter- 
mines whether a character's background pixels are set to 
with the current text-background-index. In Replace mode 
(writing-mode = 0) the pixels are set; in Overstrike mode 
(writing-mode = 1 ) they are not set. 



Likewise, a SET-BACKGROUND-INDEX command which 
changes the text-background-index \o -1 also changes the 

graphic area writing mode to overstrike. Changing the text- 
background-index \o -2 also changes the graphic area 
writing mode to replace. 

DEFAULTS 

writing-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

MG00 (Level 0): Unrecognized command. (Terminal is not 
a4112,4113,or4115.) 

MG1 1 (Level 2): Invalid writing-mode. (Must be or 1 ; in 
Setup mode, must be OVERSTRIKE or 
REPLACE.) 



Interaction with SET-BACKGROUND-INDICES Command. 

In the 41 13, the SET-GRAPHICS-AREA-WRITING-MODE 
and SET-BACKGROUND-INDICES commands both affect 
how alphatext is displayed in the graphic area. Thus, either 
of these commands can supersede the effect of the other. 

Thus, if you change a 41 13 or 41 15 terminal's graphic area 
writing mode to overstrike, the text-background-index of the 
set-background-indices command is set to -1 . If you change 
the graphic area writing mode to replace, then the text- 
background-index is set to -2. 



REFERENCES 

SET-BACKGROUND-INDICES command 
SET-DIALOG-AREA-WRITING-MODE command 



41 10 SERIES COMMAND REFERENCE 



7-269 



TEK COMMANDS 



SET-GRAPHTEXT-FONT Command 



Host Syntax 



E cMF M:font-number 



Setup Syntax 



E cMF s p font-number 



PARAMETERS 

font-number (0 to 32767). 

The character font that will be used to display subse- 
quent graphtext. 

DESCRIPTION 

This command determines which character font will be used 
to display subsequent "stroke precision" graphtext. 
Graphtext is text occurring within a GRAPHIC-TEXT com- 
mand; it can be used within graphic displays and picture 
segments, and (unlike alphatext) can be scaled, rotated, 
and slanted. 

The default graphtext font is font zero, the standard ASCII 
font. If an optional keyboard is installed, then other prede- 
fined graphtext fonts are available; Table 7-23 lists them. 

If the terminal has a Swedish, U.K., APL, or Danish/Norwe- 
gian keyboard then graphtext fonts 1 , 3, 7, and 9, in addition 
to font 0, are predefined. (A 41 15 terminal cannot have font 
7, the APL font.) If the terminal has the Katakana keyboard, 
then fonts 1 and 1 1 , as well as font 0, are predefined. If the 
terminal does not have an optional keyboard, then only font 
is predefined. 

The user can define other graphtext fonts, numbered from 
Oto 32767. (To do this, use the following commands: 
SET-GRAPHTEXT-FONT-GRID, BEGIN-GRAPHTEXT- 
CHARACTER, and END-GRAPHTEXT-CHARACTER.) 



Table 7-23 
PREDEFINED GRAPHTEXT FONTS 



Font 
Number 


Character Set 


Availability 





ASCII 


In all terminals 


1 


Swedish 


With Options 4A, 4C, 4E, 4F 


3 


U.K. 


With Options 4A, 4C, 4E, 4F 


7 


APL (except 41 1 5) 


With Options 4A, 4C, 4E, 4F 


9 


Danish/Norwegain 


With Options 4A, 4C, 4E, 4F 


10 


JIS Roman 


With Option 4K 


11 


JIS Katakana 


With Option 4K 



User-defined graphtext characters supercede predefined 
ones. Thus, you can re-define some or all of the characters 
of font 0. (If you later delete these user-defined characters, 
they are superceded by the corresponding predefined 
characters.) 

If you select a font which has no user-defined characters, 
then characters from the predefined font with the same font 
number are used. If there is no pre-defined font with that 
number, then characters from font zero (the ASCII font) are 
used. 

Any undefined characters in a user-defined font default to 
the corresponding characters of the predefined font with the 
same font number. If there is no predefined font with that 
number, the corresponding characters of font zero are used. 
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DEFAULTS REFERENCES 

font-number BEGIN-GRAPHTEXT-CHARACTER command 

as shipped — END-GRAPHTEXT-CHARACTER command 

on power-up — GRAPHIC-TEXT command 

if omitted — Graphtext-char-definition syntactic construct 

SAVE command 

SET-GRAPHTEXT-PRECISION command 
ERRORS 



MF10 (Level 2): Font does not exist, 
to 32767). 
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SET-GRAPHTEXT-FONT-GRID Command 



Host Syntax 



E cSG Mfont-number mtgrid-width mX.grid-height 



Setup Syntax 




PARAMETERS 

font-number (0 to 32767). 

Names the graphtext font for which a font grid is being 
defined. 

grid-width (1 to 4095). 

Specifies the width of each grid unit. 

grid-height (1 to 4095). 

Specifies the height of each grid unit. 



DESCRIPTION 



This command must be given before any characters are 
defined in the specified font. (An error occurs if any user- 
defined characters exist in the specified font.) 

Fonts and their asociated grids can be deleted with the 
DELETE-GRAPHTEXT-CHARACTER command. 



DEFAULTS 

font-number 

as shipped — none 
on power-up — none 
if omitted — 



The SET-GRAPHTEXT-FONT-GRID command creates a 
graphtext font and specifies the dimensions of the "grid" 
(character cell) used for defining characters in the font. 
Individual characters can be defined using the BEGIN- 
GRAPHTEXT-CHARACTER command. 

The grid width and height determine how intricate character 
can be. The grid can be considered a character cell. When 
defining a character with the BEGIN-GRAPHTEXT- 
CHARACTER command, the coordinates the terminal 
receives should stay generally within the bounds of the grid. 
Descenders can go below the grid (see Figure 7-13). 



grid- width 

as shipped — none 
on power-up — none 
if omitted — error SG21 

grid-height 

as shipped — none 
on power-up — none 
if omitted — error SG31 



However, characters can extend outside their font grids (as 
shown in Figure 7-1 3). The font grid is only used in scaling 
characters to fit the current graphtext size. 
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ERRORS 



REFERENCES 



SG02 (Level 3): Out of memory while defining font grid. 

SG10 (Level 2): Font already exists. 

SG11 (Level 2): \rviaX\d font-number (must range from 
to 32767). 

SG21 (Level 2): Invalid grid-width. (Must range from 1 
to 4095.) 

SG31 (Level 2): Invalid grid-height. (Must range from 1 
to 4095.) 



BEGIN-GRAPHTEXT-CHARACTER command 
DELETE-GRAPHTEXT-CHARACTER command 
GRAPHIC-TEXT command 
SET-GRAPHTEXT-FONT command 
SAVE-GRAPHTEXT-FONT command 
SET-GRAPHTEXT-SIZE command 
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Figure 7-13. A Font Grid, With Two Characters Defined on That Grid. 
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SET-GRAPHTEXT-PRECISION Command 



Host Syntax 



E cMQ mV.precision 



Setup Syntax 



E cMQ s p precision 



PARAMETERS 



DEFAULTS 



precision (1 or 2). 

Specifies the precision type used for graphtext 
characters. 

1 string precision 


precision 

as shipped — 2 

on power-up — 2 

if omitted — error MQ1 1 


2 stroke precision 


ERRORS 


DESCRIPTION 


MQ11 (Level 2V Invalid ru 



This command specifies whether string precision or stroke 
precision is used to draw graphtext characters. 

String precision (precision mode 1) specifies that graphtext 
is displayed exactly as is unescorted alphatext. The SET- 
GRAPHTEXT-FONT, SET-GRAPHTEXT-SIZE, SET- 
GRAPHTEXT-SLANT, and SET-GRAPHTEXT-ROTATION 
commands have no effect. (On 41 1 4, 41 1 5, and 41 1 6 termi- 
nals, only the SET-ALPHATEXT-SIZE and SET-401 4- 
ALPHATEXT-SIZE commands affect the size of string 
precision graphtext.) 

Stroke precision (precision mode 2) implies that graphtext is 
displayed according to the settings of the SET- 
GRAPHTEXT-FONT, SET-GRAPHTEXT-SIZE, SET- 
GRAPHTEXT-SLANT and SET-GRAPHTEXT-ROTATION 
commands. 



REFERENCES 

GRAPHIC-TEXT command 
SET-ALPHATEXT-FONT command 
SET-ALPHATEXT-SIZE command 
SET-GRAPHTEXT-FONT command 
SET-GRAPHTEXT-SIZE command 
SET-GRAPHTEXT-SLANT command 
SET-401 4-ALPHATEXT-SIZE command 
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SET-GRAPHTEXT-ROTATION Command 



Host Syntax 



E cMR re&Y.angle-in-degrees 



Setup Syntax 



E cMR s p angle-in-degrees 



DADAUCTCDC 
r-nnni¥ii_ i uiw 



DEFAULTS 



angle-in-degrees (-32767.0 to 32767.0). 

The rotation angle in degrees, from the direction of the 
positive x-axis. Positive angles represent counterclock- 
wise rotations, while negative angles represent clock- 
wise rotations. 



DESCRIPTION 

Specifies the counterclockwise rotation angle (in degrees) 
for all subsequent graphtext strings displayed in "stroke 
precision" mode. 



angle-in-degrees 
as shipped — 0.0 
on power-up — 0.0 
if omitted — 0.0 



ERRORS 



Default is 0.0 degrees. 



MR11 (Level 2): Invalid angle-in-degrees (must range from 
-32767.0 to 32767.0). 



REFERENCES 

GRAPHIC-TEXT command 
SET-GRAPHTEXT-PRECISION command 
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SET-GRAPHTEXT-SIZE Command 



Host Syntax 



E cMC \n\:character-width mV.character-height \ntcharacter-spacing 



Setup Syntax 



e cMC s p character-width character-height character-spacing 



PARAMETERS 



DEFAULTS 



character-width (41 1 2, 41 1 3, 41 1 4, 41 1 6: 1 to 4095; 41 1 5: 1 
to2 31 -1). 
Width of a graphtext character cell, in terminal space 
units. 



character-width 

as Shipped — 41 1 2, 41 1 3, 41 1 5: 39; 41 1 4, 41 1 6: 40 
on power-up — 41 1 2, 41 1 3, 41 1 5: 39; 41 1 4, 41 1 6: 40 
if omitted — error MC1 1 



character-height (4112,411 3, 41 1 4, 41 1 6: 1 to 4095; 41 1 5: 
1to2 31 -1). 
Height of a graphtext character cell, in terminal space 
units. 

character-spacing (41 1 2, 41 1 3, 41 1 4, 41 1 6: to 4095; 
4115:0 to2 31 -1) 
Spacing, in terminal space units, between adjacent 
character cells in the same graphtext string. 



character-height 

as shipped — 4112, 4113, 4115:52; 4114,4116:60 
on power-up — 4112, 4113, 4115:52; 4114,4116:60 
if omitted — error MC21 

character-spacing 

as shipped — 4112, 4113, 4115: 13; 4114,4116: 16 
on power-up — 4112, 4113,4115: 13; 4114,4116: 16 
if omitted — 



DESCRIPTION 



ERRORS 



The SET-GRAPHTEXT-SIZE command determines the size 
of the character for subsequent stroke-precision graphtext. 
Values are specified in terminal space units. 

The character-width and character-height define the size of 
a character. The character-spacing determines the spacing 
between the lower right corner of one character cell and the 
lower left corner of the next succeeding character cell in the 
graphtext string. 

On a 41 1 5, the terminal-settings-report for this command 
uses intc-reports, whose size is governed by the most 
recent SET-COORDINATE-MODE command. In other termi- 
nals, the report uses int-reports. 



MC11 (Level 2): Invalid character-width. (4112, 4113, 

4114,4116: 1 to 4095; 4115:1 to2 31 -1). 

MC21 (Level 2): Invalid character-height. (4112,4113, 

4114,4116: 1 to 4095; 4115: 1 to2 31 -1). 

MC31 (Level 2): Invalid character-spacing. (4112, 4113, 
41 1 4, 41 16: to 4095; 41 1 5: to 2 31 -1 ). 



REFERENCES 

GRAPHIC-TEXT command 
SET-GRAPHTEXT-FONT-GRID command 
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SET-GRAPHTEXT-SLANT Command 
Host Syntax 



E cMA rea\:slant-angle 



Setup Syntax 



E cMA s p slant-angle 



PARAMETERS ERRORS 

slant-angle (-32767.0 to 32767.0) MAOO (Level 0): Unrecognized command; firmware is 

The angle each stroke-precision graphtext character is Version 3 or earlier, 

slanted, in degrees clockwise from the vertical. MA11 ( L evel2): Invalid slant-angle (must range from 

-32767.0 to 32767.0). 

DESCRIPTION 

REFERENCES 

This command specifies the slant each stroke precision 

Graphtext character has from the vertical. The slant-angle GRAPHIC-TEXT command 

parameter specifies the slant in degrees clockwise from the SET-GRAPHTEXT-ROTATION command 

vertical. If you specify a negative slant, the character is SET-GRAPHTEXT-SIZE command 
slanted counter-clockwise. 

DEFAULTS 

slant-angle 

as shipped — 0.0 
on power-up — 0.0 
if omitted — 0.0 
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SET-IMAGE-ORIENTATION Command 



OPTION 09 



Host Syntax 




Setup Syntax 




PARAMETERS 

orientation (0 to 3). 

Selects the orientation of the hardcopy image with 
respect to the hardcopy media. Setup mode parameters 
are HORIZONTAL, VBOTTOM, VCENTER, and VTOP. 

HORIZONTAL: long axis of image on long 
axis of media 

1 VBOTTOM: long axis of image on short axis 
of media, at bottom 

2 VCENTER: long axis of image on short axis 
of media, centered 

3 VTOP: long axis of image on short axis of 
media, at top 



DESCRIPTION 

The SET-IMAGE-ORIENTATION command sets the orienta- 
tion of the hardcopy image with respect to the hardcopy 
media (the paper or transparency on the hardcopy 
machine). Figure 7-14 shows the possible orientations of 
the image with respect to the media. Figures 7-1 4A through 
7-1 4D show the results of assigning orientations through 
3, respectively. 

On the TEKTRONIX 4691 Color Graphics Copier, assigning 
orientations 1 through 3 are all equivalent to assigning 
orientation 2 (Figure 7-1 4C). 



This command is recognized only by a 41 1 3 or 41 1 5 termi- 
nal with the Option 09 color hardcopy interface installed. 
The orientation of an image becomes apparent when the 
HARDCOPY command (or the HARD COPY key or 401 0- 
HARDCOPY command) is issued after a SELECT-HARD- 
COPY-INTERFACE command has chosen the Option 09 
color hardcopy interface. 

DEFAULTS 

orientation 

as shipped — 

on power-up — remembered 

if omitted — 



ERRORS 

QO00 (Level 0): Unrecognized command (Option 09 is not 
installed). 

Q011 (Level 2): Invalid orientation (must be from to 3). 



REFERENCES 

HARDCOPY command 
HARD COPY key 

SELECT-HARDCOPY-INTERFACE command 
4010-HARDCOPY command 
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Figure 7-14. Orientation of Copier Images to Media. 
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SET-KEY-EXECUTE-CHARACTER Command 



Host Syntax 




Setup Syntax 




PARAMETERS 

key-execute-char (0 to 1 27). 

Numeric equivalent of the ASCII character which delim- 
its the "execute locally" part of a macro definition. 

DESCRIPTION 

This command sets the value of the key-execute-character, 
used with the DEFINE-MACRO command. 



When a key-macro is expanded by the operator pressing 
the associated key, the contents of the macro are initially 
routed to the host computer. When a key-execute-character 
is encountered in the macro, it is discarded and the macro 
contents are routed to the terminal. Each subsequent key- 
execute-character encountered "toggles" the destination of 
the macro contents (from terminal to host, or from host to 
terminal) and is discarded (not displayed or transmitted). 

DEFAULTS 



Normally, when the operator presses a key which has been 
programmed (with the DEFINE-MACRO command), the 
characters programmed into the key are sent to the host 
computer, just as if the operator had typed those characters 
manually. This includes characters which comprise an 
"escape sequence" command for the terminal; the termi- 
nal, instead of executing such a command, sends the char- 
acters which comprise it to the host. 

The key-execute-character provides a way around this prob- 
lem. Within a key definition, the key-execute-character 
marks the beginning and end of a sequence of characters 
which the terminal is to execute locally rather than send to 
the host. 

The key-execute-character has this special effect only when 
the macro containing it is invoked by pressing a key. If, 
instead, the macro is invoked with an EXPAND-MACRO 
command, then the key-execute-character is treated like any 
other character in the macro definition. 



key-execute-char 
as shipped — 1 6 
on power-up — remembered 
if omitted — 



ERRORS 

KY11 (Level 2): Invalid key-execute-char (must be 
to 127). 

REFERENCES 

DEFINE-MACRO command 
EXPAND-MACRO command 
Key-execute-character 
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Host Syntax 



E cML \n\:line-index 



Setup Syntax 



E cML s p line-index 



PARAMETERS 

line-index (0 to 32767). 

In a 41 1 2, 41 1 3, or 41 15, this is the color index with 
which subsequent lines are to be drawn. In a 41 14 or 
4116, the line index is stored in segments as graphic 
information, but is used only when drawing those seg- 
ments on a plotter. (See MAP-INDEX-TO-PEN 
command.) 



DESCRIPTION 

On a 41 1 2, 41 13 or 41 15, the SET-LINE-INDEX command 
specifies the color index with which subsequent lines, panel 
boundaries, and markers are to be drawn. There is a maxi- 

r*-«i im *\r\\r\r inrlnv f<-\r onw ngrti/Milgr qi ii-fo/^Q J ^ = CM-tO looo thon 
■ i iui ii uuiui iiiuCa iui ai iy patuuuiai oui iuvw wh^ ivsOo u iwi i 

2 M , where M is the number of bit planes assigned to that 
surface. If the color index in effect when a line is drawn is 
greater than the maximum index for the surface, the line is 
drawn using the maximum index. 

The actual intensity for each value depends on the current 
gray-level or color mixture for the particular color index. For 
details, see the descriptions of the SET-SURFACE-GRAY 
LEVELS and SET-SURFACE-COLOR-MAP commands. 

On a 41 1 4 and 41 1 6, The SET-LINE-INDEX command 
defines the pen index for subsequent output to a plotter. 
(See the MAP-INDEX-TO-PEN command for details.) When 
drawn on the screen, alt lines appear green (or orange if the 
line is in Refresh on a terminal with Option 34). 



Alino'c inrjpy ic an attrihi ito nf a nrnnhi^ nrimitivo Hnro a 

segment has been defined, any line within that segment is 
always drawn in the same line index. 



DEFAULTS 

line-index 

as shipped — 41 1 2: 7; 41 1 3, 41 1 5: 1 4114,411 6: 255 
on power-up — 41 1 2: 7; 41 1 3, 41 1 5: 1 4114,4116: 255 
if omitted — 



ERRORS 

ML1 1 (Level 2): Invalid line-index. (Must range from 
to 32767.) 



REFERENCES 

DRAW command 
DRAW-MARKER command 
MAP-INDEX-TO-PEN command 
PLOT command 

SET-SURFACE-COLOR-MAP command 
SET-SURFACE-DEFINITIONS command 
SET-SURFACE-GRAY-LEVELS command 
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SET-LINE-STYLE Command 



Host Syntax 



E cMV int: line-style 



Setup Syntax 



E cMV s p line-style 



PARAMETERS 

line-style (0 to 7). 

Specifies the line style for vectors drawn on the screen. 

solid line 

1 to 7 a specific dashed-line style 



DESCRIPTION 

The SET-LINE-STYLE command selects one of eight differ- 
ent line styles for subsequent graphics: solid lines, dashed 
lines, etc. The default line style on power-up is line style — 
solid lines. On a 41 14 or 41 1 6, if the dialog area is not 
enabled, then a PAGE or c r resets the current line style to 
this default. 

This command also resets the dashed line generator to the 
beginning of the selected line style pattern. 

A line's style is an attribute of a graphic primitive. Once a 
segment has been defined, any line within that segment is 
always drawn in the same line style. 

Figure 7-1 5 shows samples of the eight line styles. 



DEFAULTS 

line-style 

as shipped — 
on power-up — 
if omitted — 



ERRORS 

M V1 1 (Level 2): Invalid line-style. (Must range from to 7.) 

REFERENCES 

DRAW command 
PAGE command 
SET-4014-LINE-STYLE command 



Line Style 



Figure 7-15. Line Styles, 
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SET-LINE-WIDTH Command 



4114,4116 



Host Syntax 




Setup Syntax 



E cMW s p width 



PARAMETERS 



DEFAULTS 



Specifies narrow or wide lines for drawing vectors on the 
screen. 



narrow lines 

wide lines (defocused beam) 



DESCRIPTION 

The SET-LINE-WIDTH command lets you defocus the 41 14 
or 41 1 6's electron beam, so that it draws lines which are 
wider than normal. The parameter is for narrow lines, and 
1 for wide lines (defocused beam). 

For purposes of defining segments, line width is deemed to 
be a primitive attribute (an attribute of a graphic primitive). 
As such, it cannot be changed once a segment has been 
defined. Once a segment has been defined, any line within 
that segment is always drawn in the same line width. 



as shipped — 
on power-up — 
if omitted — 



ERRORS 



MWOO (Level 0): Unrecognized command. (The terminal is 
nota4114or4116.) 

MW1 1 (Level 2): Invalid width. (Must be either or 1 .) 



REFERENCES 

DRAW command 
SET-4014-LINE-STYLE command 
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SET-MARGINS Command 



4114,4116 



Host Syntax 



E cKM mtnumber-of-margins 



Setup Syntax 




PARAMETERS 

number-oj -margins (1 to 8). 

Specifies the number of margins (or number of columns) 
which the 41 14 or 41 1 6 uses when displaying alphatext 
outside the dialog area. 

DESCRIPTION 

The SET-MARGINS command determines the number of 
margins (or number of columns) which the terminal uses 
when displaying text on the screen. In doing so, it also 
defines when it is that a "page full condition" occurs. 



One Margin. If the parameter is 1 , the terminal has only one 
margin : "margin 1 ," at the left edge of the screen. Each c r 
moves the alpha cursor to the left edge of the screen. Each 
l f moves the alpha cursor down one line. Characters typed 
beyond the end of a line "wrap around" to the beginning of 
the next line, as if a c R L F had been received. 



More Than One Margin. If the parameter is 2, there are 2 
margins defined; if it is 3, there are 3 margins defined, and 
so on. The maximum number of margins is eight. 

With N margins in effect, the screen is divided into N 
columns of equal width. Margin 1 is at the left edge of the 
leftmost column; margin N is at the left edge of the right- 
most column. 

Initially, margin 1 is in effect. When the cursor reaches the 
bottom of the screen, and l f or wrap-around condition 
occurs, the alpha cursor moves to the top of column 2, and 
margin 2 goes into effect. Subsequent carriage returns (or 
wrap-arounds) will move the cursor left only to margin 2; the 
text in column 1 will not be overwritten. 

Likewise, if more than 2 margins are defined, when the 
cursor reaches the bottom of column 2 it advances to the 
top of column 3. This continues until the bottom of the last 
column is reached, whereupon a "page-full" condition 
occurs. 



With only one margin, a "page full" condition occurs when 
the cursor is already at the bottom of the screen and l f or 
"wrap-around" occurs. 
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Page-Full Condition. When a page-full condition occurs, 
the subsequent action depends on the most recent SET- 
PAGE-FULL-ACTION command: 

• If the SET-PAGE-FULL-ACTION command specified "no 
action," then the alpha cursor moves to the top of mar- 
gin one. Subsequent alphatext will overprint whatever is 
already displayed on the screen. 

• If some other action was specified in the SET-PAGE- 
FULL-ACTION command, then that other action occurs. 
Seethe description of the SET-PAGE-FULL-ACTION 
command for details. 



ERRORS 

KMOO 

(Level 0): 

Unrecognized command. (The terminal is not a 41 14 or 

4116.) 

KM11 

(Level 2): 

Invalid number-of-margins (must range from 1 to 8). 

REFERENCES 



DEFAULTS 

number-of-margins 
as shipped — 2 
on power-up — c 
if omitted — error KM1 1 



CRLF command 
LFCR command 
PAGE command 
PAGE key 
SET-PAGE-FULL-ACTION command 
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SET-MARKER-TYPE Command 



Host Syntax 



E cMM \nt:marker-number 



Setup Syntax 



E cMM s p marker-number 



PARAMETERS 



ERRORS 



marker-number (0 to 1 0). 

Specifies which marker type is used when the terminal 
draws a marker. See Figure 7-1 6 for the list of marker 
types. 



MM11 (Level 2): Invalid marker number (must range from 
0to10). 



REFERENCES 



DESCRIPTION 

This command specifies which marker type appears when 
the terminal draws a marker. 

Markers are drawn approximately the same size as similar 
characters in the default alphatext size. 



ENTER-MARKER-MODE command 
DRAW-MARKER command 



DEFAULTS 

marker-number 
as shipped — 
on power-up — 
if omitted — 
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Marker Number 4112, 4113, 4115 4114, 4116 
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Figure 7-16. Appearance of Markers on Different Terminals. 
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SET-NUMBER-OF-COPIES Command 



OPTION 09 



Host Syntax 



E cQN mtnumber-of-copies 



Setup Syntax 



HCCOPIES s p number-of-copies 



PARAMETERS 



DEFAULTS 



number-of-copies (0 to 64). 

Selects the number of copies that are produced when a 

color hardcopy operation is invoked. 

DESCRIPTION 

The SET-NUMBER-OF-COPIES command sets the number 
of copies that are produced each time a HARDCOPY or 
401 0-HARDCOPY command is received or the HARD 
COPY key is pressed, when the color copier interface has 
been selected with the SELECT-HARDCOPY-INTERFACE 
command. 



number-of-copies 
as shipped — 1 
on power-up — 1 
if omitted — 1 



ERRORS 



QN00 (Level 0): Unrecognized command (Option 09 is not 
installed). 

QN1 1 (Level 2): Invalid number-of-copies parameter 
(range is to 64). 



If you assign as the parameter, one copy is produced. If 
you assign a positive number greater than 64, the number- 
of-copies parameter is set to 64. 

The number-of-copies parameter is decremented after each 
copy; the final value of the parameter is 1 . 

This command sets the number of hardcopies that are pro- 
duced only for 41 1 3 and 41 1 5 terminals with the Option 09 
color hardcopy interface installed. 



REFERENCES 

HARDCOPY command 
HARD COPY key 

SELECT-HARDCOPY-INTERFACE command 
401 0-HARDCOPY command 
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SET-OVERVIEW-WINDOW Command 



4115 



Host Syntax 




Setup Syntax 




PARAMt I EkS 

first-corner (X = -2 31 to2 31 -1, Y = -2 31 to 2 31 -1) 
Specifies the first corner of the overview window. 

second-corner (X = -2 31 to2 31 -1, Y = -2 31 to 2 31 -1) 
Specifies the second corner of the overview window. 

DESCRIPTION 

This command specifies the full overview window and par- 
tial overview window for the current view. These two win- 
dows are used when the OVERVIEW and CTRL- 
OVERVIEW keys are pressed. It also defines the alphatext 
window, and the home position for the current view. The x- 
and y-coordinates you specify are sorted so as to give the 
lower-left and upper-right corners of the full overview win- 
dow. 

When the 41 15 OVERVIEW key is pressed, the window is 
set to the most recent partial overview window set by this 
command in this view. When the 41 1 5 CTRL-OVERVIEW 
key is pressed, the window is set to the most recent full 
overview window set by this command in this view. 



Partial Overview Window. The partial overview window is 
the bottom four-fifths of the full overview window set by this 
command. See the 4110 Series Host Programmers Manual 
for details on the interaction between the partial overview 
window and the full overview window. 



Home Position. The home position is the beam position 
that results when the PAGE command is executed or the 
PAGE key is pressed when the dialog area is disabled. The 
home position is in the upper-left corner of the partial over- 
view window. 

The home position (HX.HY) is calculated as 

HX = the left edge of the full overview window 



HY = YTOP- 
= YTOP - 



(27/1280) 
(27/1279) 



(M 
M 



+ 1)-1 



if M > 1280 
if M < 1280 



where 



YTOP = the top of the full overview window 
M = the height of the full overview window 



Alphatext Window. The alphatext window has the same 
right, left, and bottom edges as the full overview window, 
but its top is the home position's y-coordinate. Alphatext 
cannot be displayed outside of the alphatext window. If the 
beam position is outside the alphatext window when a u s 
character is received, it is moved to the closest point on the 
edge of the alphatext window. 

Alphatext is printed from left to right and the lines are filled 
from top to bottom. When alphatext reaches the right edge 
of the alphatext window, it wraps to the left edge of the 
following line. When the alphatext reaches the bottom of the 
alphatext window, it wraps to the left edge of the top of the 
alphatext window. 

The home position and alphatext window are automatically 
set when the terminal receives this command. 
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DEFAULTS 



ERRORS 



first-corner 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 

second-corner 

as shipped — (4095,4095) 
on power-up — (4095,4095) 
if omitted — (4095,4095) 



UW00 (Level 0): Unrecognized command. (Terminal is not 
a4115.) 

UW11 (Level 2): \nva\\6 first-corner parameter (both X and 
Y must be from -2 31 to 2 31 -1). 

UW21 (Level 2): Invalid second-corner parameter (both X 
and Y must be from -2 31 to2 31 -1). 



REFERENCES 



ENTER-ALPHA-MODE command 
OVERVIEW Key 
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Host Syntax 



E cKP mV.page-full-action 



Setup Syntax 



PAGEFULL s p page-full-action 



r«r»Mivic i cno 

page-full-action (0 to 7). 

Sets the page-full action, as follows: 

No action. (Setup mode keyword: NONE) 

1 Wait for key push. 

(Setup mode keyword: STOP) 

2 Perform hardcopy, then page. 
(Setup mode keyword: AUTOCOPY) 

3 Hardcopy, then wait for key push, then page. 
(Setup mode keyword: 3) 

4 Send break signal to host. 
(Setup mode keyword: BREAK) 

5 Send break, then wait for key push, 
(Setup mode keyword: 5) 

6 Send break, then do hardcopy and page. 
(Setup mode keyword: 6) 

7 Send break, then do hardcopy then wait for 
key push, then page. 

(Setup mode keyword: 7) 



If the parameter is 0, there is no page-full action. 

If the parameter is 1 . 3, 5, or 7, output to the display is 
stopped until a key is pressed. 

If the parameter is 2, 3, 6, or 7, when a page-full condition 
occurs, an automatic hard copy is generated. If int = 2 or 6, 
then the screen is erased after the hard copy. If int = 3 or 7, 
the screen is erased after the hard copy and after a key is 
pressed. 

If the parameter is 4, 5, 6, or 7, a "break" is sent to the host, 
just as if the operator had pressed the BREAK key. 

Once set in a given mode, the page-full-action continues in 
that mode until it is specifically changed with another SET- 
PAGE-FULL-ACTION command. 



DEFAULTS 

page-full-action 
as shipped — 
on power-up — remembered 
if omitted — 



DESCRIPTION 

This command specifies the action (if any) which the termi- 
nal performs when a page-full condition occurs. A page-full 
condition occurs when the dialog area is disabled and the 
alpha cursor "wraps" off the bottom of the last margin in the 
graphics area. "Wrapping" occurs when the cursor is on the 
bottom line and the terminal receives a linefeed, or when 
the cursor is at the end of the bottom line and the terminal 
receives a printable character. 4112,4113, and 41 1 5 termi- 
nals have only one margin. 41 1 4 and 41 1 6 terminals can 
have up to eight margins, as set by the SET-MARGINS 
command. 



ERRORS 

KP1 1 (Level 2): Invalid page-full-action. (Must range from 
to 7.) 



REFERENCES 

HARDCOPY command 
PAGE command 
SET-MARGINS command 



41 10 SERIES COMMAND REFERENCE 



7-291 



TEK COMMANDS 



7-292 4110 SERIES COMMAND REFERENCE 



Section 7 (cont) Page 

SET-PANEL-FILLING-MODE Command 7-293 

SET-PARITY Command 7-298 

SET-PICK-APERTURE Command 7-299 

SET-PICK-ID Command 7-300 

SET-PIVOT-POINT Command 7-302 

SET-PIXEL-BEAM-POSITION Command 7-303 

SET-PiXEL-VIEVVPORT Command 7-304 

SET-PIXEL-WRITING-FACTORS Command 7-306 

SET-PORT-BAUD-RATE Command 7-308 

SET-PORT-EOF-STRING Command 7-309 

SET-PORT-EOL-STRING Command 7-31 1 

SET-PORT-FLAGGING-MODE Command 7-312 

SET-PORT-PARITY Command 7-314 

SET-PORT-STOP-BITS Command 7-316 

SET-PROMPT-STRING Command 7-318 

SET-QUEUE-SIZE Command 7-319 

SET-REPORT-EOM-FREQUENCY Command 7-321 

SET-REPORT-MAX-LINE-LENGTH Command 7-323 

SET-REPORT-SIG-CHARS Command 7-325 

SET-SEGMENT-CLASS Command 7-327 
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SET-PANEL-FILLING-MODE Command 



4112,4113,4115 



Host Syntax 




Setup Syntax 



E cMS s p overstrike/ replace cover-boundary pattern-keying-mode 



overstrike/replace (0 or 1). 

Specifies Overstrike or Replace mode. 

Replace mode 

1 Overstrike mode 

cover-boundary (0 or 1). 

Specifies whether the boundary of the panel is covered 
when the panel is filled. 



no 
yes 



pattern-keying-mode (0 to 3). 

Specifies the position (direction^ of the fi!!-r>attern within 
the panel. 

no change to keying 

1 keyed to viewport position 

2 keyed to lower left panel pixel 

3 keyed to absolute screen position 



DESCRIPTION 

This command determines how subsequent paneis are to 
be filled. 



Overstrike/Replace. The overstrike /replace parameter 
determines the effect of zeroes in the fill pattern. If this 
parameter is one ("overstrike"), then when subsequent 
panels are filled, pixels in the panel interior which corres- 
pond to zeroes in the fill pattern are left unchanged. If, how- 
ever, the overstrike/replace parameter is zero ("replace"), 
then when subsequent panels are filled, zeroes in the fill 
pattern cause the corresponding pixels in the panel interior 
to be set to color index 0. Figure 7-1 7 shows the effect of the 
overstrike/replace parameter. 



Cover-Boundary. The cover-boundary parameter deter- 
mines whether, when panels are filled, their boundaries are 
filled as well as their interiors. If this parameter is zero, only 
panel interiors will be filled; if one, then the interiors are 
filled and the boundaries are covered. 

If a BEGIN-RANEL-BOUNDARY command specifies that 
the panel boundary is to be drawn, but the SET-PANEL- 
FILLING-MODE command specifies that the filling opera- 
tion is to include the boundary as well as the interior, then 
the "covering the boundary" supercedes "drawing the 
boundary." That is, the boundary is first drawn, and then 
later (when an END-PANEL command is received), it is 
covered over with the fill pattern. 
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A. Replace Mode. 



B. Overstrike Mode. 
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Figure 7-17, Effect of Overstrike/Replace Parameter, 
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Pattern Keying. The pattern-keying-mode parameter 
determines how the fill pattern itself is positioned within a 
panel being filled. 

If this parameter is 0, the present pattern keying mode is not 
changed. 



If this parameter is 1 , the fill pattern is "keyed to the current 
viewport." Figure 7-18 shows the concept. The fill pattern to 
be used is replicated over the entire viewport, starting at the 
lower left corner of the viewport. Then that part of the (repli- 
cated) fill pattern which falls within the panel to be filled is 
used to fill the panel. 
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Figure 7-18. Keying a Fill Pattern to the Current Viewport. 
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If the pattern-keying-mode parameter is 2, then the fill 
pattern is keyed to the leftmost pixel in the bottom row of 
pixels in the panel being filled. The process is the same as 
described above, except that when replicating the fill 
pattern, the terminal starts at the lower left corner of the 
panel rather than the lower left corner of the current view- 
port. Figure 7-19 shows the result. 

If the parameter is 3, then the fill pattern is keyed to the 
lower left corner of the screen. The process is as before, 
except that, when replicating the fill pattern, the 41 12 starts 
at the lower left corner of raster memory space (rather than 
the lower left corner of the viewport or the leftmost pixel in 
the bottom line of the panel being filled). Figure 7-20 shows 
the effect. 

When keying to the viewport or to the screen, panels join 
each other smoothly, with no discernable interruption in the 
fill pattern. When keying to the panel being filled, however, 
each panel is filled starting at the leftmost pixel of that pan- 
el's bottom line, so there will usually be a "jump" or inter- 
ruption in the fill pattern at the boundaries between adjacent 
panels. 



DEFAULTS 

overstrike/ replace 
as shipped — 
on power-up — 
if omitted — 

cover-boundary 
as shipped — 
on power-up — 
if omitted — 

pattern-keying-mode 
as shipped— 1 
on power-up — 1 
if omitted — 
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VIEWPORT ONE 




Figure 7-19. Keying a Pattern to the Panel Being Filled. 
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ERRORS 



REFERENCES 



MSOO (Level 2): Unrecognized command. (Terminal is not 
a4112,4113,or4115.) 

MS1 1 (Level 2): Invalid overstrike/ replace parameter 
(must be or 1). 

MS21 (Level 2): Invalid cover-boundary parameter (must 
beOorl). 

MS31 (Level 2): Invalid pattem-keying-mode (must be 0, 
1,2, or 3). 



BEGIN-FILL-PATTERN command 
BEGIN-PANEL-BOUNDARY command 
END-PANEL command 
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Figure 7-20. Keying a Fill Pattern to the Screen. 
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SET-PARITY Command 



Host Syntax 



E cNP \nX\parity-mode 



Setup Syntax 



PARITY s p parity-mode 



PARAMETERS 

parity-mode (0 to 4). 

Specifies the parity mode the terminal uses in sending 
data to the host. Setup mode parameters are NONE, 
ODD, EVEN, HIGH, and DATA 

NONE; the terminal ignores parity in charac- 
ter it receives from the host, and sets the 
parity bit to zero in characters it sends to the 
host. 

1 ODD; the terminal ignores parity in charac- 
ters it receives, but uses odd parity in 
characters it transmits to the host. 

2 EVEN; the terminal ignores parity in charac- 
ters it receives, but uses even parity in 
characters it transmits. 

3 HIGH; the terminal ignores parity in charac- 
ters it receives, and sets the parity bit to one 
in characters it transmits. 

4 DATA; the terminal treats the eighth bit in 
each character as another data bit. 



DESCRIPTION 

Places the terminal in the specified parity mode. 

This command determines how the parity bit is set in char- 
acters which the terminal sends to the host. (The terminal 
ignores the parity bit in characters it receives from the host 
except if the parity-mode is 4.) 



Parity NONE. If mode (NONE) is selected, the terminal 
sets the parity bit to zero in characters it sends to the host. 



ODD Parity. If mode 1 (ODD) is selected, then when the 
terminal sends a character to the host, it sets the parity bit in 
that character to one or zero, whichever is required so that 
the character will have an odd number of bits set to one. 



EVEN Parity. If mode 2 (EVEN) is selected, then the termi- 
nal sets the parity bit to one or zero, whichever is required 
so that the character will have even parity. 



HIGH Parity. If mode 3 (HIGH) is selected, then the terminal, 
when sending a character to the host, sets the parity bit to 
one. 



DATA Parity. If mode 4 (DATA) is selected, then the terminal 
uses the eighth bit in each character as another data bit. 
Using Ms parity-mode setting with the high bit (parity bit) 
set to zero is the same as 7-bit ASCII. 



DEFAULTS 

parity-mode 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

NP11 (Level 2): Invalid parity-mode. (Must range from to 4. 

REFERENCES 

SET-PORT-PARITY command 



7-298 



41 10 SERIES COMMAND REFERENCE 



SET-PICK-APERTURE Command 



TEK COMMANDS 



Host Syntax 



E clA \n\:aperture-width 



Setup Syntax 



GINPICKAPERTURE s p aperture-width 



PARAMETERS 

aperture-width (0 to 4095). 

Specifies the width of the pick aperture. 



DESCRIPTION 

This command sets the size of the pick aperture. 



Explanation. The pick aperture is a square in normalized 
screen space, centered on the current beam position. 
During a GIN pick operation part of the segment picked 
must fall within the pick aperture. (See ENABLE-GIN 
command and GIN-pick-report for details.) 

The aperture-width parameter sets the width of the pick 
aperture square, in normalized screen coordinate units. If 
the width is zero, then part of the segment being picked 
must fall exactly at the current cursor position. If the width 
is 4, then part of the segment being picked must have its 
x-coordinate in the range from X0 - 2 to X0 + 2, and its 
y-coordinate in the range from Y0 - 2 to Y0 + 2, where 
(X0.Y0) is the current beam position in normalize screen 
space. 



Th, 



, nnorUtro-wirfth ma\r ho any int in tho rannp frrtm In 
■ «^w# *«.. w .,,**... .. — j -^ *~. . 3 .... ... 3 - .. .- 



4095. If the parameter is omitted (by terminating the 
command early), the terminal assumes a value of zero. Very 
large pick apertures, although allowed, are impractical. 

In the 41 1 2, 41 1 3, and 4115, the specified size of the pick 
aperture is an approximate number. Because of the 
rounding that occurs when transforming coordinates from 
terminal space to raster memory space (and vice-versa), it is 
possible to pick a line that is slightly outside the stated 
aperture. 



DEFAULTS 

aperture-width 
as shipped — 
on power-up — 
if omitted — 



ERRORS 

IA1 1 (Level 2): Invalid aperture-width (must range from 
to 4095). 

REFERENCES 

ENABLE-GIN command 
INCLUDE-COPY-OF-SEGMENT command 
GIN-pick-report syntactic construct 
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SET-PICK-ID Command 



Host Syntax 



E cMI m\:pick-ID-number 



Setup Syntax 



E cMI s p pick-ID-number 



PARAMETERS 

pick-ID-number (0 to 32767). 

Specifies the pick-ID for parts of the currently open 
segment. 

DESCRIPTION 

When a segment is "picked" during a graphic input opera- 
tion, the pick identification number for the portion of the 
segment within the pick aperture is returned to the host 
computer. This permits the host computer to know, not only 
which segment the operator picked, but also which part of 
the segment was picked. 

The SET-PICK-ID command inserts a flag into the display 
list for the segment being defined. The SET-PICK-ID 
command is considered a graphic primitive; however, unlike 
other graphic primitives, it has no direct effect on the 
appearance of a picture. 

If, during the pick operation, the pick aperture is so large 
as to cover parts of the segment with different p/c^-ZZ) 
numbers, then the terminal returns the last of the pick-IDs 
in the display list for parts of the segment within the pick 
aperture. If, on the other hand, no visible, detectable seg- 
ment falls within the pick aperture, the terminal sends a 
GIN-pick-report in which [he pick-ID number is zero. 



If several detectable and visible segments are in the pick 
aperture, then the highest priority segment is picked. 

The pick-ID numbers are integers in the range from to 
32767. However, only those-parts of a segment which are 
flagged with positive pick-ID numbers can be picked. A 
pick-ID number marks a part of a segment which cannot be 
picked. The default pick-ID is 1 . 

The BEGIN-SEGMENT command resets the pick-ID 
number to one. While defining the segment, you can issue 
SET-PICK-ID commands to label subsequent parts of the 
segment with different pick-ID numbers. 

NOTE 

To make it easier to create "menus," the 
INCLUDE-COPY-OF-SEGMENT command does 
not copy the initial (assumed) pick-ID. 

The flags inserted in the segment by SET-PICK-ID com- 
mands are deemed to be graphic primitives. As such, they 
are permanent parts of the segment and cannot be changed 
once the segment has been defined. Therefore, the SET- 
PICK-ID command is only valid while a segment is being 
defined. If you issue a SET-PICK-ID command while no 
segment is currently being defined, the terminal detects a 
type MI03 error. 
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DEFAULTS REFERENCES 

pick-ID-number BEGIN-SEGMENT command 

as shipped — ENABLE-GIN command 

on power-up — GIN-pick-report syntactic construct 
if omitted — 



ERRORS 

MI03 (Level 2): Command is invalid at this time. (No 
segment is currently being defined.) 

MM 1 (Level 2): Invalid pick-ID-number. (Must range from 
to 32767.) 
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SET-PIVOT-POINT Command 



Host Syntax 



E cSP xy.pivot-point 



Setup Syntax 



E cSP s p pivot-point 



PARAMETERS 

pivot-point (4112, 4113, 4114, 4116: X = to 4095, Y = 
to 4095; 41 1 5: X = -2 31 to 2 31 -1 , Y = -2 31 to 
2 31 -1). 
Specifies the pivot point for subsequent segment 
definitions and graphtext characters definitions. 



DESCRIPTION 

This command specifies the pivot point for subsequent 
segment and graphtext character definitions. 

For segments, the pivot point is the point used when a 
segment is created as the initial position. The first move or 
draw is assumed to be relative to the pivot point, the second 
move or draw is assumed relative to the first, and so on. 
That is, a newly created segment begins with an absolute 
move to its pivot point (specified by this command), and all 
following moves, draws, and graphic primatives are relative 
to the pivot point and each other. 

The location of the pivot point is the "position" of the seg- 
ment. It can be changed by the SET-SEGMENT-POSITION 
and SET-SEGMENT-IMAGE-TRANSFORM commands. The 
actual xy value of the pivot point when the segment is 
created is only saved in the segment for use by the SAVE 
and REPORT-SEGMENT-STATUS commands. 

This command changes the default segment position that is 
otherwise set by the SET-SEGMENT-POSITION and SET- 
SEGMENT-IMAGE-TRANSFORM commands, to be the 
same as the new pivot point. 

For graphtext characters, the pivot point is the point which 
defines the "lower left corner" of the character cell when 
the character is later displayed. Within the character defini- 



tion, the character cell extends from the pivot point to the 
right by "width" terminal space units, and from the pivot 
point upward by "height" units, where "width" and "height" 
are determined by the most recent SET-GRAPHTEXT- 
FONT-GRID command. 

The pivot point is a static attribute; once a segment (or 
graphtext character) has been defined, its pivot point with 
respect to the segment (character) itself cannot be changed 
(that is, all graphic primitives in the segment have the same 
relationship to the pivot point no matter how the segment is 
positioned, rotated, or scaled). However, since the pivot 
point defines the initial position of the segment, it can be 
relocated within the viewport. 

The pivot point is the point at which subsequent graphic 
objects and segments begin. For image transforms (see 
SET-SEGMENT-IMAGE-TRANSFORM command), the pivot 
point is the point around which rotation occurs and about 
which all scaling occurs in both x- and y-directions. 

DEFAULTS 

pivot-point 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 

REFERENCES 

BEGIN-GRAPHTEXT-CHARACTER command 
BEGIN-SEGMENT command 
SET-GIN-CURSOR command 
SET-GRAPHTEXT-FONT-GRID command 
SET-SEGMENT-IMAGE-TRANSFORM command 
SET-SEGMENT-POSiTiON command 
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SET-PIXEL-BEAM-POSITION Command 



4112,4113,4115 



Host Syntax 



E cRH xy '.beam- position 



Setup Syntax 



E cRH xy.beam-position 



PARAMETERS 



nrcAin tc 



beam-position (41 1 2, 41 i 3: X = to 639, Y = to 479; 
4115:X = 0tOl279,Y = 0to1023). 
Position, relative to the pixel viewport's lower left corner, 
where the next RASTER-WRITE or RUNLENGTH- 
WRITE command will take effect. 



DESCRIPTION 

This command sets the pixel-beam-position in the pixel 
viewport, for use by subsequent RASTER-WRITE or 
RUNLENGTH-WRITE commands. The pixel-beam-position 
coordinates are relative to the lower left corner of the pixel 
viewport in raster memory space. 



41 1 2, 41 13. The SET-PIXEL-VIEWPORT command initial- 
izes the pixel-beam-position to the upper left corner of the 
pixel viewport. If the proposed pixel beam position is out- 
side the current pixel viewport, then it is set to the nearest 
pixel within the pixel viewport. 



beam-position 

as shipped — 4112,4113: (0,479); 4115: (0,1 023) 
on power-up — 41 12, 41 13: (0,479); 41 15: (0,1023) 
if omitted — (0,0) 



ERRORS 

RH00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 



REFERENCES 

RASTER-WRITE command 
RUNLENGTH-WRITE command 
SET-PIXEL-VIEWPORT command 
SET-PIXEL-WRiTING-FACTORS command 



4115. The SET-PIXEL-VIEWPORT command initializes the 
pixel-beam-position to the pixel viewport home position, 
which is defined by the SET-PIXEL-WRITING-FACTORS 
command. On power-up, this is the upper-left corner of the 
pixel viewport. If the proposed pixel-beam-position is out- 
side the current pixel viewport, then it is set to the nearest 
pixel within the pixel viewport tnat allows one pixei rectan- 
gle (as defined by the SET-PIXEL-WRITING-FACTORS 
command) to be written inside the viewport. 
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SET-PIXEL-VIEWPORT Command 



4112,4113,4115 



Host Syntax 



E cRS xy.first-corner xy.second-corner 



Setup Syntax 



E cRS s p first-corner second-corner 



PARAMETERS 

first-corner (41 1 2, 41 1 3: X = to 639, Y = to 479; 4115: 
X = 0to1279,Y = 0to1023). 
Specifies, in raster memory space coordinates, one 
comer of the pixel viewport. 

second-corner (41 1 2, 41 1 3: X = to 639, Y = to 479; 
4115:X = 0to1279,Y = 0tOl023). 
Specifies the opposite corner of the pixel viewport. 



DESCRIPTION 

This command sets the pixel viewport position on the 
pixel-operations writing surface. (The "pixel-operations writ- 
ing surface" is the surface named in the most recent 
BEGIN-PIXEL-OPERATIONS command.) The SET-PIXEL- 
VIEWPORT command also updates the current pixel beam 
position to the upper left corner of the pixel viewport on the 
41 1 2 and 4113 terminals, and to the point specified by the 
last SET-PIXEL-WRITING-FACTORS command on 41 15 
terminals. 

The first-corner and second-corner coordinates are in raster 
memory space. If an x-coordinate greater than 639 (41 1 2 or 
41 1 3) or 1 279 (41 1 5), or a y-cordinate greater than 479 
(4112 or 41 13) or 1 023 (41 1 5), is specified, then the terminal 
detects an error. 



The first-corner and second-corner coordinates may 
actually be the coordinates of any two diagonally opposite 
corners of the pixel viewport. The terminal will set Xmin (the 
x-coordinate of the leftmost pixel in the pixel viewport) to the 
lesser of the two specified x-coordinates. It will set Xmax 
(the x-coordinate of the rightmost pixel) to the larger of the 
two x-coordinates. Likewise, it will sort the y-coordinates in 
the proper order to determine the y-coordinates of the 
bottom and top of the pixel viewport. 

On a 41 1 5, if the pixel viewport is smaller than the pixel 
rectangle defined by the most recent SET-PIXEL-WRITING- 
FACTORS command, an error is detected and the pixel 
viewport is not changed. 



DEFAULTS 

first-corner 

as shipped — (0,0) 

on power-up — remembered 

if omitted — (0,0) 

second-corner 

as shipped — 4112,4113: (639,479); 41 1 5: (1 279, 1 023) 
on power-up — remembered 
if omitted — 1[0,0) 



7-304 



41 10 SERIES COMMAND REFERENCE 



TEK COMMANDS 



ERRORS 

RSOO (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 411 3, or 41 15.) 

RS1 1 (Level 2): \rw/a\\d first-corner coordinate. (41 1 2, 

4113:X = to 639, Y = to 479; 4115: 
X = 0to1279,Y = 0tOl023.) 

RS21 (Level 2): Invalid second-corner coordinate (41 12, 
4113:X = to 639, Y = to 479; 41 15: 
X = to 1 279, Y = to 1 023), or the pixel 
viewport is smaller than the current pixel 
rectangle (41 15 only). 



REFERENCES 

BEGIN-PIXEL-OPERATIONS command 
SET-PIXEL-BEAM-POSITION command 
RASTER-WRITE command 
RUNLENGTH-WRITE command 
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SET-PIXEL-WRITING-FACTORS Command 



4115 



Host Syntax 




Setup Syntax 



e cRT s p pixel-width pixel-height major-axis 



PARAMETERS 



DESCRIPTION 



pixel-width (-1 280 to 1 280). 

Specifies the width of the pixel and the horizontal direc- 
tion of display. With positive widths, pixels are placed 
from left to right; with negative widths, pixels are placed 
from right to left. A value of is interpreted as 1 . 

pixel-height (-1 024 to 1 024). 

Specifies the height of the pixel and the vertical direction 
of display. With positive heights, pixels are placed from 
top to bottom; with negative heights, pixels are placed 
from bottom to top. A value of is interpreted as 1 . 

major-axis (0 or 1). 

Specifies the direction in which adjacent pixels are 
placed, horizontal or vertical. 

adjacent pixels are placed horizontally 

1 adjacent pixels are placed vertically 



This command allows you to control the size of the pixel 
rectangle that is produced for each pixel contained in 
RASTER-WRITE and RUNLENGTH-WRITE commands, 
and to control the direction in which pixels are written on the 
screen. The home position of the pixel viewport is also 
affected (see Table 7-24). 

If the pixel rectangle's width or height are larger than the 
current pixel viewport, an error is detected and this com- 
mand is ignored. 

When a pixel is being displayed as the result of a RASTER- 
WRITE or RUNLENGTH-WRITE command, a pixel 
rectangle the size of the absolute values of the pixel-width 
and pixel-height and of all the same color index is put into 
raster memory, starting at the current pixel-beam-position 
and extending in the directions indicated by the signs of the 
pixel-width and pixel-height parameters. If the entire pixel 
rectangle does not fit into the pixel viewport, the pixel- 
beam-position is first moved to the beginning of the next row 
(or column, depending on the direction of display), before 
the rectangle is displayed. 

The number of pixels in the display space which are actually 
filled for each pixel specified in a RASTER-WRITE or 
RUNLENGTH-WRITE command is specified by the pixel- 
width and pixel-height parameters. The writing direction is 
specified by the signs of those two parameters, and by the 
major-axis parameter, as shown in Table 7-24. 
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Table 7-24 
COMBINATIONS OF DIRECTIONS 



major-axis 


pixel-width sign 


pixel-height sign 


Direction Pixels Are Placed 


Pixel Viewport Home Position 





+ 


+ 


Lto R, top-down 


Top-left corner 





+ 


- 


L to R, bottom-up 


Bottom-left corner 





- 


+ 


R to L, top-down 


Top-right corner 





- 


- 


R to L, bottom-up 


Bottom-right corner 


1 


+ 


+ 


Top-down, L to R 


Top-left corner 


1 


+ 


- 


Bottom-up, L to R 


Bottom-left corner 


1 


- 


+ 


Top-down, R to L 


Top-right corner 


1 


- 


- 


Bottom-up, R to L 


Bottom-right corner 



!f there have been RASTER-WRITE or RUNLENGTH- 
WRITE commands since the last SET-PIXEL-BEAM- 
POSITiON or SET-PIXEL-VIEWPORT command, and you 
change the pixel-width parameter from positive to negative, 
or vice versa, then the pixel-beam-position moves one pixel 
in the new pixel-width direction. Likewise, if you change the 
pixel-height parameter from positive to negative, or vice 
versa, then the pixel-beam-position moves one pixel in the 
new pixel-height direction. 

If either one of these adjustments results in the beam 
position moving outside the pixel viewport, then the beam is 
moved to the opposite edge of the viewport. 

You can avoid this adjustment of the pixel-beam-position by 
setting the pixel-width or pixel-height parameter to (which 
is neither positive nor negative) before assigning the 
parameter a value of the opposite sign. 

DEFAULTS 



ERRORS 

RTOO 'L.gv©! QV Unrecoonizsd command. Terminal is not 
a4115.) 

RT1 1 (Level 2): Invalid pixel-width or width is larger than 
the pixel viewport width (range is -1280 to 
1280). 

RT21 (Level 2): Invalid pixel-height or height is larger than 
the pixel viewport height (range is -1024 
to 1024). 

RT31 (Level 2): Invalid major-axis (must be or 1). 



REFERENCES 



RASTER-WRITE command 
RUNLENGTH-WRITE command 
SET-PIXEL-VIEWPORT command 



pixel-width 

as shipped — 
on power-up — 
if omitted — 

pixel-height 

as shipped — 
on power-up — 
if omitted — 

major-axis 

as shipped — 
on power-up — 
if omitted — 
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SET-PORT-BAUD-RATE Command 



OPTION 10 



Host Syntax 



E cPR device:port mtbaud-rate 



Setup Syntax 



PBAUD s p port baud-rate 



PARAMETERS 



ERRORS 



port. 

Names the RS-232 peripheral port whose baud rate is 
being specified. Valid ports are: 

P0: 
P1 
P2 

baud-rate. 

The data rate (bits/second) used at the specified 
peripheral port. Valid rates are: 50, 75, 1 10, 134, 150, 
300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, and 
9600. 



DESCRIPTION 

This command sets the baud rate used at one of the three 
RS-232 peripheral ports. The terminal "remembers" this 
setting even when powered off. 

DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PR1 1 

baud-rate 

as shipped — 2400 

on power-up — remembered 

if omitted — error PR21 



PR00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PR11 (Level2): Invalid port (must be P0:, P1:, orP2;). 

PR1 2 (Level 3): Out of memory while parsing the 
parameter. 

PR13 (Level 2): Port is busy. 

PR21 (Level 2): Invalid baud-rate (must be 50, 75, 1 1 0, 
1 34, 1 50, 300, 600, 1 200, 1 800, 2000, 
2400, 3600, 4800, 7200, or 9600). 



REFERENCES 

SET-BAUD-RATES command 
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SET-PORT-EOF-STRING Command 



OPTION 10 



Host Syntax 



E cPE dev\ce:port M-anay.EOF-string 



Setup Syntax 



PEOF s p port EOF-string 



PARAMETERS 

port. 

Names the peripheral port for which an end-of-file string 
is being specified. Valid ports are: 

P0 
P1 
P2 

EOF-string. 

An array with length of up to ten ints. Each represents a 
single ASCII character, and so must be in the range from 
0to127. 



DESCRIPTION 

This command sets the end-of-file string used when a 
peripheral device is connected to the specified RS-232 
peripheral port. When, during a copy to that device, an end- 
of-file condition (EOF) is detected, the terminal sends the 
specified end-of-file string and terminates the copy 
operation. 



i_ir\oV¥i5c, uuiiiivj a vur i iuui nuni a penuntff ell pull, ine 

EOF-string marks the end of the copy or pcopy operation. 
That is, the terminal terminates the COPY or PCOPY when 
it detects the EOF-string in the characters coming from the 
peripheral device. 



Port Name. The first parameter in the SET-PORT-EOF- 
STRING command is a string naming the peripheral port. 
This must be P0:, P1 :, or P2:. 



End-of-File String. The command's second parameter is an 
int-array holding the numeric equivalents of the characters 
which comprise the EOF-string. Each int in this array is the 
numeric equivalent of an ASCII character, and so must be in 
the range from to 1 27. There may be as many as ten ints 
in the array. 

DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PE1 1 



EOF-string 

as shipped — empty array 
on power-up — remembered 
if omitted — empty array 
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ERRORS 

PEOO (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PE11 (Level2): Invalidport (mustbePO:, P1:,orP2:). 

PE12 (Level 3): Out of memory while parsing the 
parameter. 

PE13 (Level 2): Port is busy. 

PE21 (Level 2): Invalid EOF-string. (The int-array must 
have from to 10 elements, and each int 
in the array must range from to 1 27.) 

PE22 (Level 3): Out of memory while parsing the 



REFERENCES 

SET-EOF-STRING command 
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SET-PORT-EOL-STRING Command option 10 

Host Syntax 



E cPM device:por? \n\-array.EOL-string 



Setup Syntax 



PEOL s p port EOL-string 



HARAMfc l tHS ERRORS 

port. PMOO (Level 0): Unrecognized command. (Option 10 is 

Names the RS-232 peripheral port for which an EOL- not installed.) 

string is being specified. Valid ports are: pMl1 (Leve , 2): invalid port. (Must be P0:, P1:, or P2:.) 

0: PM12 (Level 3): Out of memory while parsing the 

" parameter. 

PM13 (Level 2): Port is busy. 

EOL-string. PM22 (Level 3): Out of memory while parsing the 

An array with length of up to two ints. Each int is the parameter 

numeric equivalent of a single ASCII character, and so 
must be in the range from to 1 27. 

REFERENCES 

DESCRIPTION PORT-ASSIGN command 

Sets the end-of-line string for the specified port. This string 
replaces every c r in the data going to a port if (and only if) 
the 4643 protocol is set for that port. The most used EOL- 
string is C R L F. 

DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PE1 1 

EOL-string 

as shipped — empty array 
on power-up — remembered 
if omitted — empty array 
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SET-PORT-FLAGGING-MODE Command 



OPTION 10 



Host Syntax 




Setup Syntax 



PFLAG s p port flagging-mode GO-eharacter STOP-character 



PARAMETERS 



DESCRIPTION 



port. 

Names the RS-232 peripheral port for which a flagging 
mode is being specified. Valid ports are: 

P0 
P1 
P2 

flagging-mode (0, 1 , or 2). 

Specifies the type of flagging the terminal uses for the 
specified port. Setup mode parameters are NONE, 
CHAR, and DTR/CTS. 

NONE; no flagging 

1 CHAR; character flagging 

2 DTR/CTS; flagging with DTR, CTS signal 
lines 



Sets the flagging mode for the specified host port number to 
which the peripheral will be attached. 



Character Flagging. When the terminal sends data to a 
peripheral device, that device can signal that it is not ready 
for more characters by sending a STOP-character. The 
terminal then stops sending characters to the peripheral 
device; it resumes transmission only on receipt of a 
GO-character Uom the peripheral device. 

Likewise, when receiving data from a peripheral device, the 
terminal may send a STOP-character \a the peripheral 
device when it is not yet ready to receive more characters. 
When the terminal is ready, it sends the GO-character to the 
peripheral device, causing the peripheral device to resume 
transmission. 



GO-character (0 to 1 27). 

The numeric equivalent of a single ASCII character. If 
flagging-mode is 1 (CHAR), this character means, "I am 
ready for more data; go ahead and send it," when the 
terminal sends it to the device attached to the specified 
port. 

STOP-character (0 to 1 27). 

The numeric equivalent of a single ASCII character. If 
flagging-mode is 1 (CHAR), this character means, "I am 
not ready for data; stop sending data to me," when the 
terminal sends it to the device attached to the specified 
port. 



This flagging mode is the default mode, with D i - ASCII 
decimal equivalent 1 7 - as the GO-character, and D 3 - ADE 
1 9 - as the STOP-character. If the third parameter is zero (or 
omitted by terminating the command early), the terminal 
sets the GO-character to D i . If the fourth parameter is zero 
(or omitted), the terminal sets the STOP-character \o D 3. 
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DTR/CTS Flagging. In sending data to a peripheral device 
(typically, a printer for this kind of flagging), the terminal 
continues to send characters so long as the peripheral 
device places a positive voltage on the DTR (Data Terminal 
Ready) line at the RS-232 connector for that peripheral 
device. If the printer (or other peripheral device) places a 
negative voltage on DTR, the terminal stops sending char- 
acters until DTR goes positive again. 

In receiving data from a peripheral device, the terminal 
places a positive voltage on the CTS (Clear To Send) line at 
the RS-232 connector for that peripheral device. Should the 
terminal momentarily be "too busy" to receive characters, it 
places a negative voltage on CTS. This should cause the 
peripheral device to stop transmitting characters. When the 
terminal is ready to receive more characters, it sends 
CTS-positive again. 



ERRORS 

PFOO (Level 0): 

PF11 (Level 2): 

PF12 (Level 3): 

PF13 (Level 2) 

PF21 (Level 2) 

PP<»1 l\ owol 0\ 



Unrecognized command. (Option 10 is 
not installed.) 

Invalid port (must be P0:, P1 :, or P2:). 

Out of memory while parsing the 
parameter. 

Port is busy. 

Invalid flagging-mode (must be 0, 1 or 2). 



Invalid GO-character ^roust be from to 
127). 

PF41 (Level 2): Invalid STOP-character (must be from to 
1 27; if non-zero, must be different from 
the GO-character). 



DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PF1 1 



REFERENCES 

SET-FLAGGING command 



flagging-mode 
as shipped — 1 
on power-up — remembered 
if omitted — 

GO-character 
as shipped — 17 
on power-up — remembered 
if omitted — 17 

STOP-character 
as shipped — 19 
on power-up — remembered 
if omitted — 19 
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SET-PORT-PARITY Command 



OPTION 10 



Host Syntax 



E cPP device .port \x\\:parity-mode 



Setup Syntax 



PPARITY s p port parity-mode 



PARAMETERS 

port. 

Names the RS-232 peripheral port whose parity mode is 
being specified. Valid ports are: 

P0 
P1 
P2 

parity-mode (0 to 4). 

Specifies the parity mode for data sent through the 
specified port. Setup mode parameters are LOW, ODD, 
EVEN, HIGH, and NONE. 






LOW; the parity bit is set to zero 


1 


ODD 


2 


EVEN 


3 


HIGH; the parity bit is set to one 


4 


NONE; the parity bit is omitted 


DESCRIPTION 



The SET-PORT-PARITY command determines whether 
characters at the peripheral ports have parity bits. If the 
characters do have parity bits, the SET-PORT-PARITY 
command also specifies how those parity bits are set. 

NOTE 

The meaning of the "parity type" parameter in this 
command is not the same as the meaning of the 
corresponding parameter in the SET-PARITY 
command. 



Figure 7-21 shows the format of characters exchanged 
between the terminal and a device attached to an RS-232 
peripheral port. Each character begins with a start bit. After 
the start bit come from 5 to 8 data bits, an optional parity bit, 
and one or two stop bits. The start bit is always zero ("pace" 
or "travail" condition on the data communications line). The 
stop bits are always one ("mark" or "repos" condition). The 
numbers of data bits and of stop bits are determined by the 
SET-PORT-STOP-BITS command. Whether or not there is a 
parity bit is determined by the SET-PORT-PARITY 
command. 



Port Specifier String. The SET-PORT-PARITY command's 
first parameter is a string naming the peripheral port whose 
parity attribute is being set. 



Parity Type. The command's second parameter specifies 
the parity type. 

If the parity type parameter is 0, then low parity is used at 
the peripheral port. Each character includes a parity bit. 
The terminal transmits this bit as a "0," and ignores this bit 
in characters it receives from a peripheral device. 

If this parameter is 1 , then odd parity is used at the specified 
peripheral port. Each character (or other six-, seven-, or 
eight-bit data byte) includes a parity bit. In transmitting 
characters to a peripheral device, the terminal sets this bit 
to 1 or 0, whichever is needed to give an odd number of " 1 " 
bits (not counting the start and stop bits). Likewise, when 
receiving characters from a device at the peripheral port, 
the terminal checks for odd parity. That is, it checks that 
there are an odd number of "1 " bits (not counting the start 
and stop bits). 
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If the parity type parameter is 2, then even parity is used at 
the peripheral port. Each transmitted character includes a 
parity bit. The parity bit is 1 or 0, whichever is necessary to 
make the character have an even number of "1 " bits (not 
counting the start and stop bits). 

If the parity type parameter is 3, then high parity is used at 
the peripheral port. Each character includes a parity bit. 
The terminal always transmits this bit as a "1 ". The parity 
bit is ignored in characters received from a peripheral 
device. 



DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PP1 1 

parity-mode 
as shipped — 4 
on power-up — remembered 
if omitted — 



If this parameter is 4, the parity bit is omitted. 

For normal operation with the ASCII character set, there 
should be seven data bits, one parity bit, and one or two 
stop bits. Therefore, the SET-PORT-PARITY command 
should have a parity mode parameter of 0, 1 , 2, or 3. (Parity 
mode 4 shouid be avoided, as that causes the parity bit to 
be omitted.) 



ERRORS 

PP00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PP11 (Level 2): Invalid port (must bePO:, P1:,orP2:). 

PP12 (Level 3): Out of memory while parsing the 
parameter. 

PP13 (Level 2): Port is busy. 

PP21 (Level 2): Invalid parity-mode (must be from to 4). 



REFERENCES 

SET-PARITY command 



THE COMMUNICATIONS LINE IS IN MARK' CONDITION 
UNTIL THE CHARACTER BEGINS WITH A START BIT. 



THE LINE REMAINS IN MARK' CONDITION 
UNTIL THE START OF THE NEXT CHARACTER. 



I I I I I 



MARK 



SPACE 



START BIT' 
(ALWAYS SPACE) 



V 

5,6,7, OR 8 DATA BITS, 
AS DETERMINED BY THE 
<SET-PORT-STOP-BITS> 
COMMAND. 



x, 



OR 2 STOP BITS, 
AS DETERMINED BY THE 
< SET-PORT-STOP-BITS> 
COMMAND. 



PARITY BIT 



3892-19 



Figure 7-21 . Format of a Character at the RS-232 Peripheral Ports. 
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SET-PORT-STOP-BITS Command 



OPTION 10 



Host Syntax 



E cPB device.port mtnumber-of-stop-bits mknumber-of-data-bits 



Setup Syntax 




PARAMETERS 



DESCRIPTION 



port. 

Names the RS-232 peripheral port for which the 
numbers of stop bits and data bits are being specified. 
Valid ports are: 

P0 
P1 
P2 

number-of -stop-bits {^ or 2). 

Specifies the number of stop bits in each byte of data for 
the specified port. 

number-of-data-bits (5, 6, 7, or 8). 

Specifies the number of data bits in each byte of data for 
the specified port. This count does not include the parity 
bit, whose presence or absence is determined by the 
SET-PORT-PARITY command. 



The SET-PORT-STOP-BITS command sets the number of 
stop bits and data bits used in characters sent between the 
terminal and its RS-232 peripheral ports. This command 
requires that Option 10 be installed. 

Figure 7-22 shows the format of a character (or data byte) 
transmitted between the terminal and one of its RS-232 
peripheral ports. Each character has a start bit, which is 
always (a positive voltage, corresponding to the "space" 
or "travail" condition at the RS-232 interface). After the start 
bit come from 5 to 8 data bits; the number of data bits is 
determined by the most recent SET-PORT-STOP-BITS 
command. After the data bits comes the parity bit; this bit 
may be omitted, depending on the most recent SET-PORT- 
PARITY command. After the parity bit comes one or two 
stop bits. The number of stop bits is determined by the most 
recent SET-PORT-STOP-BITS command. The stop bits are 
always 1 (a negative voltage, corresponding to a "mark" or 
"repos" condition at the RS-232 interface). 



Port Name. The first parameter in the SET-PORT-STOP- 
BITS command is a string naming the RS-232 peripheral 
port to which the command applies. 



Number of Stop Bits. The second parameter is an int 
naming the number of stop bits. This parameter must be 
eitherl or 2. 



Number of Data Bits. The third parameter is an int naming 
the number of data bits. This parameter must be 5, 6, 7, 
or 8. 
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DEFAULTS 

port 

as shipped — none 
on power-up — none 
if omitted — error PB11 

number-of-stop-bits 
as shipped — 2 
on power-up — remembered 
if omitted — error PB21 

number-of-data-bits 
as shipped — 8 
on power-up — remembered 
if omitted — error PB21 



ERRORS 

PBOO (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PB11 (Level 2): Invalid port (must be P0:, P1:, or P2:). 

PB1 2 (Level 3): Out of memory while parsing the 
parameter. 

PB13 (Level 2): Port is busy. 

PB21 (Level 2): Invalid number-of-data-bits (must be 1 
or 2). 

PB31 (Level 2): \r\va\\d number-of-data-bits {must be 5, 6, 
7, or 8). 

REFERENCES 

SET-STOP-BITS command 



THE COMMUNICATIONS LINE IS IN MARK' CONDITION 
UNTIL THE CHARACTER BEGINS WITH A START BIT. 



THE LINE REMAINS IN MARK' CONDITION 
UNTIL THE START OF THE NEXT CHARACTER. 



I I I I 



I I I 



I I I 



MARK 



SPACE 



.-> 



START BIT' 
(ALWAYS SPACE) 



v 

5,6,7, OR 8 DATA BITS, 
AS DETERMINED BY THE 
<SET-PORT-STOP-BITS> 
COMMAND. 



x, 



OR 2 STOP BITS, 
AS DETERMINED BY THE 
< SET-PORT-STOP-BITS> 
COMMAND. 



PARITY BIT 



3892-19 



Figure 7-22. Format of Characters at the RS-232 Peripheral Ports. 
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SET-PROMPT-STRING Command 



Host Syntax 



E cNS \nX-array.prompt-string 



Setup Syntax 



PROMPTSTRING s p prompt-string 



PARAMETERS 



ERRORS 



prompt-string. 

An array with length of up to ten ints. Each int is the 
numeric equivalent of a single ASCII character, and so 
must be in the range from to 1 27. 

DESCRIPTION 



NS1 1 (Level 2): Invalid prompt-string. (Must be an array 
holding from to 1 ints. Each of the 
items in the array must be an int in the 
range from to 1 27.) 

NS12 (Level 3): Out of memory while parsing the 
parameter. 



Specifies the character sequence that is accepted as a 
prompt sequence when received from the host. The string 
can be up to 10 characters. If the string is a null string (has 
zero characters), prompt mode is disabled, since a null 
string is always there when the terminal searches for it. 



REFERENCES 

PROMPT-MODE command 



DEFAULTS 

prompt-string 

as shipped — 63,32 

on power-up — remembered 

if omitted — empty array 
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SET-QUEUE-SIZE Command 



Host Syntax 



E cNQ \r\\:queue-size 



Setup Syntax 



QUEUESIZE s p queue-size 



PARAMETERS 

queue-size (1 to 65535). 

Number of memory bytes reserved for the 
communications input queue. 



DESCRIPTION 



Ippninn *3 GCTVOI 'I— I Id CI7C ■ M nr\mrr\&r\r\ ^oiicoq th^ 
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terminal to reserve at least N eight-bit bytes for its communi- 
cations input queue. The actual queue size may be some- 
what larger than N; however, it will be at least N bytes large. 

The terminal "remembers" the queue size setting even 
when turned off. When the terminal is shipped from the 
factory, it maximum queue size is set to 300 bytes. 



This command reserves part of the terminal's memory as a 
storage area for the terminal's communications input 
queue. 

If the queue size requested is larger than the available 
memory, then all available memory is allocated to the 
communications queue and a type NQ02 error is detected. 



Explanation. Sometimes characters come from the host 
computer at a rate faster than the terminal can process 
them. This can happen especially when those characters 
comprise commands to perform lengthy and complicated 
operations : INCLUDE-COPY-OF-SEGMENT, SAVE: 
segments-all, etc. 

When characters arrive faster than the terminal can process 
them, the terminal stores them in its communications input 
queue until it has a chance to process them — or until the 
memory allocated for that queue is exhausted. (If the queue 
memory is exhausted, incoming characters are lost.) 

Specifying a large maximum queue size permits the termi- 
nal to buffer more characters before data is lost. Specifying 
a small communications queue size leaves more of the 
terminal's memory available for other uses. 



NOTE 

The 4112 and 4113 can display simple alpha- 
numerics and graphics up to a maximum continu- 
ous data rate of 9600 bits/second. The 4114, 4115, 
and 41 16 can display simple alphanumerics and 
graphics up to a continuous data rate of 19200 bits/ 

j / r ru:~ -j~~~ ... ~+ :~~i — r ... -,J„ ... £.:„;.. 
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require more than routine processing, such as the 
LOAD or INCLUDE-COPY-OF-SEGMENT com- 
mands.) At higher data rates, some "handshaking" 
protocol must be used to prevent the terminal's 
communications input queue from overflowing. 

Moreover, even at slow data rates, it is prudent to 
use a handshaking protocol. The terminal can take 
an appreciable amount of time to execute some 
commands — such as LOAD or SAVE : segments- 
all — which can be issued using only a very few 
characters. If a handshaking protocol is not used, 
the terminal's input queue may overflow while 
executing such commands. 
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Such a handshaking protocol might be as simple as 
issuing a REPOR T-4010-STATUS command from 
time to time, and waiting to receive the reply before 
issuing more commands to the terminal. Alterna- 
tively, any of several data communications proto- 
cols may be used: flagging mode, prompt mode, or 
block mode. Any of these communications modes 
will prevent the input queue from overflowing. 



DEFAULTS 

queue-size 

as shipped — 300 

on power-uo — remembered 

if omitted — error NQ1 1 



ERRORS 

NQ01 (Level 3): Cannot free enough currently allocated 
queue memory. 

NQ02 (Level 3): Out of memory while performing SET- 
QUEUE-SIZE command. 

NQ1 1 (Level 2): Invalid queue-size. (Must range from 1 to 
65535.) 



REFERENCES 

ARM-FOR-BLOCK-MODE command 
SET-BAUD-RATES command 
SET-FLAGGING-MODE command 
SET-PROMPT-MODE command 
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SET-REPORT-EOM-FREQUENCY Command 



Host Syntax 



E clM mV.EOM-frequency 



Setup Syntax 



REOM s p EOM-frequency 



PARAMETERS 

EOM-frequency (0 or 1 ). 

Specifies whether EOM-indicators should be sent 
more or less frequently in reports to the host. "More 
frequently" means at the end of each part of the mes- 
sage; "less frequently" means only when needed to 
prevent the maximum line length from being exceeded. 



less frequently 
more frequently 



DESCRIPTION 

The command controls how frequently the terminal 
Intersperses EOM-indicators among the characters that 
comprise a "report message" that the terminal sends to the 
host computer: GIN-report-sequences, device-status-reports, 
port-status-reports, segment-status-reports, terminal-set- 
tings-reports, etc. 

Generally speaking, setting the EOM-frequency to " 1 " 
(more frequent) causes a long message to be broken into 
separate lines of text for each part of the report. For 
instance, each GIN-report within a GIN-report-sequence 
would occupy a separate line of text, terminated with an 
EOM-indicator. 

Setting the EOM-frequency to "0" (less frequent) permits 
several parts of a report to fit on the same line of text. For 
instance, several GIN-reports could fit on the same line. 
The line is terminated with an EOM-indicator only when the 
terminal's maximum line length is about to be exceeded. 



EOM-indicators. The EOM-indicator 'end-of-messa^e 
indicator) serves to mark the end of a "line of text" in data 
being sent to the host. If the terminal is not in block mode, 
the EOM-indicator is the current end-of-line string, as 
defined by the most recent SET-EOL-STRING command. In 
block mode, the terminal sends an EOM-indicator by 
terminating the block and setting the "end-of-message" bit 
in the block-control-bytes. 



Report Messages. "Report messages" are messages 
which the terminal sends in response to such commands as 
ENABLE-GIN, REPORT-ERRORS, REPORT-DEVICE- 
STATUS, and so on. Exactly where EOM-indicators occur 
within a report messages depends on the syntax for the 
particular type of report message: 

» For GiN reports, see the descriptions of GIN-report- 
sequence, GIN-locator-report, GIN-pick-report, and 
GIN-stroke-report. 

• For other reports ("inquiry" reports), see the 

descriptions of the REPORT-DEVICE-STATUS, REPORT- 
ERRORS, REPORT-PORT-STATUS, REPORT- 
SEGMENT-STATUS, and REPORT-TERMINAL- 
SETTINGS commands. 



DEFAULTS 

EOM-frequency 
as shipped — 1 
on power-up — remembered 
if omitted — 1 
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ERRORS REFERENCES 

IM11 (Level 2): Invalid EOM-frequency setting (must be GIN -locator-report syntactic construct 

or 1 ). GIN-pick-report syntactic construct 

GIN-report-sequence syntactic construct 
GIN-stroke-report message type 
REPORT-DEVICE-STATUS command 
REPORT-PORT-STATUS command 
REPORT-SEGMENT-STATUS command 
REPORT-TERMINAL-SETTINGS command 
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SET-REPORT-MAX-LINE-LENGTH Command 



Host Syntax 



E clL mtmax-line-length 



Setup Syntax 



RLINELENGTH s p max-line-length 



PARAMETERS 

max-line-length (0 to 65535). 

The maximum number of characters per line in reports 
which the terminal sends to the host. Setting this param- 
eter to zero disables the maximum-line-length feature. 



DESCRIPTION 

The command sets the maximum line length for report 
messages which the terminal sends to the host computer. It 
also determines how frequently the terminal intersperses 
EOM-indicators among data being transferred to the host in 
a COPY, SPOOL, SAVE, PLOT, or DIRECTORY command. 
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feature; in effect, the maximum line length is set to infinity. 



Re n ort Messages, If the terminal has a report to send to the 
host, and that report would cause the maximum line length 
to be exceeded, then the terminal inserts an EOM-indicator 
into the report. The EOM-indicator serves to terminate the 
current line of text. 

The exact places where EOM-indicators may be inserted 
are described in the syntax of the particular report type. For 
details, see the description of the individual report type: 

device-status-report 

GIN -report-sequence 

port-status-report 

segment-status-report 

terminal-settings-report 

char-report 

int-report 

xy-report 



EOM-indicators. The terminal uses EOM-indicators (end- 
of-message indicators) to force the end of a line of text in 
data it sends to the host. If the terminal is not in block mode, 
it substitutes, for each EOM-indicator in the data, the 
current EOL-string, as determined by the most recent SET- 
EOL-STRING command. In block mode, however, the 
terminal merely terminates the block and sets the end-of- 
message bit in the block-control-bytes. 



Other Data Sent To The Host. When the terminal sends 
data to the host in response to a copy, spool, save, plot, or 
directory command, it intersperses EOM-indicators in that 
data, so as to break the data into "lines of text." Each such 
line of text has the maximum line length, as determined by 
the SET-REPORT-MAX-LINE-LENGTH command. 

This feature is to accommodate host computers which 
cannot reliably accept lines of more than a certain number 
of characters. The feature can be disabled by setting the 
terminal's maximum line length to zero. 
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NOTE 

Even if the data being transferred already contains 
c r characters (or other EOM-chars>, the terminal 
still inserts a c r (or other EOL-string^ after every 
max-line-length characters of data. 

Therefore, if you will be transferring data that is 
already broken into individual lines of text, you 
should set the terminal's max-report-line-length to 
zero, thereby disabling the "maximum line length " 
feature. (Alternatively, you can set the EOL-string 
to the empty string.) 



DEFAULTS 

max-line-length 
as shipped — 
on power-up — 
if omitted — 



REFERENCES 

Char-report parameter type 
COPY command 

Device-status-report message type 
DIRECTORY command 
EOM-indicator syntactic construct 
GIN -report-sequence message type 
Int-report parameter type 
PLOT command 

Port-status-report message type 
SAVE command 

Segment-status-report message type 
SPOOL command 

Terminal-settings-report message type 
XY-report parameter type 



ERRORS 

IL1 1 (Level 2): Invalid max-line-length. (Must range from 
to 65535.) 
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SET-REPORT-SIG-CHARS Command 



Host Syntax 



E clS ml.report-type-code \nt:sig-char \v\\:term-sig-char 



Setup Syntax 



RSIGCHARS s p report-type-code sig-char term-sig-char 



pARAMl i tHS 

report-type-code (-3 to -1 , or a valid GIN device-function). 
If this is a GIN device-function code, then the signature 
characters defined in this command will be used in GIN- 
report-sequences for that device- function code. If this 
parameter is -3, then these signature characters are 
used in non-GIN report messages. If the parameter is -2, 
these signature characters are used only when respond- 
ing to REPORT GIN-POINT: -2 commands. If the 
parameter is minus one, then these signature characters 
are used in all report messages (both GIN reports and 
non-GIN reports). 

DESCRIPTION 

This command assigns the "signature characters" to be 
used within report messages which the terminal sends to 
the host computer. 



Report Type Code. The first parameter specifies in which 
type of report these signature characters will be used. 

or a positive number represents a GIN device-function 
code; see the description of the ENABLE-GIN command for 
details. Future GIN-report-sequences for that device- 
function combination will use the signature characters 
specified in this SET-REPORT-SIG-CHARS command. 

-3 specifies "inquiry reports" - report messages sent in 
response to non-GIN commands, such as REPORT- 
TERMINAL-SETTINGS, REPORT-ERRORS, REPORT- 
PORT-STATUS, etc. 
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commands only. 

-1 specifies "ail reports" - inquiry reports and reports for all 
GIN device-function combinations. 



Sig-Char. The second parameter is the numeric equivalent 
of the ASCII character which is to be used as the sig-char in 
reports of the specified type. If the sig-char is set to n l — 
numeric equivalent of zero — then that sig-char is omitted 
from reports sent to the host. 



Term-Sig-Char. The third parameter specifies the character 
to be used as the term-sig-char in reports of the specified 
type. If the term-sig-char is N i_, then it is omitted in reports 
sent to the host. 

NOTE 

If GIN is enabled for more than one device at a 
time, then, for best results, set different sig-chars 
and term-sig-chars for each enabled GIN device. 
This is necessary in order that the host computer 
can parse the iw/erfeavecfGIN-report-sequences 
which can be sent to the host if more than one GIN 
device is active. 

Also, if non-GIN reports are requested while GIN 
is enabled, then different sig-chars and term-sig- 
chars are needed to distinguish non-GIN reports 
from GIN reports. 

On power up, all signature characters are initialized to n l. 
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DEFAULTS 



REFERENCES 



report-type-code 
as shipped — none 
on power-up — none 
if omitted — 

sig-char 

as shipped — 
on power-up — 
if omitted — 



GIN-locator-report syntactic construct 
GIN-pick-report syntactic construct 
GIN -report-sequence syntactic construct 
GIN-stroke-report syntactic construct 
REPORT-DEVICE-STATUS command 
REPORT-ERRORS command 
REPORT-PORT-STATUS command 
REPORT-SEGMENT-STATUS command 
REPORT-TERMINAL-SETTINGS command 



term-sig-char 
as shipped — 
on power-up — 
if omitted — 



ERRORS 

1011 (Level 2): Invalid report-type-code. (Must be a valid 
device-function code, or range from -1 
to -3.) 

IS21 (Level 2): Invalid sig-char. (Must range from to 
127). 

IS31 (Level 2): Invalid term-sig-char. (Must range from 
to 127.) 
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SET-SEGMENT-CLASS Command 



Host Syntax 



E cSA mtsegment-number M-anay.removal-array \nt-anay.addition-array 



Setup Syntax 




PARAMETERS 

segment-number (-3 to -i , or 1 to 32767). 

Names the segment whose classes are being altered. 

-3 all segments that match the current 

matching class 

-2 the default for segments yet to be defined 

-1 all segments 

1 to 32767 a specific segment 

removal-array (-1 , 1 to 64). 

Lists the segment classes that are being removed from 
the specified segment. 



-1 
1 to 64 



all classes 
a specific class 



addition-array (-1 , 1 to 64). 

Lists the segment classes that are being added to the 
specified segment. 

-1 all classes 

1 to 64 a specific class 



DESCRIPTION 

The SET-SEGMENT-CLASS command alters the classes 
that are assigned to a segment for use in segment matching 
operations. 

The segment number may be -3, -2, -1 , or any positive 
segment number for an existing segment. Segment -3 
means all segments that match the current matching class. 
Segment -2 means default for new segments not yet 
defined. Segment -1 means all currently existing segments. 



Class numbers may be -1 (meaning "all classes" 
number in the range from 1 to 64. 



I, or any 



Each segment has a set of classes which belong to it. This 

uuiiiiiicu iu aucia it us sci uy in 01 ici nuvii ty n ic uiaoo^o 

specified in the removal-array and then adding the classes 
specified in the addition-array. Removing a class that is not 
in a segment's set, or adding a class that is already there, 
does not cause an error. ' 



The 4100 Series Host Programmers Manual contains further 
discussion of segment classes and how to set a segment's 
class-set. 
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DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — error SA1 1 

removal-array 

as shipped — empty array 
on power-up — empty array 
if omitted — empty array 

addition-array 

as shipped — empty array 
on power-up — empty array 
if omitted — empty array 



SA21 (Level 2): Invalid removal-array. (Each class 

number must be -1 or range from 1 to 64, 
array count must be from to 65535.) 

SA22 (Level 3): Out of memory while parsing parameter. 

SA31 (Level 2): Invalid addition-array. (Each class 

number must be -1 or range from 1 to 64, 
array count must be from to 65535.) 

SA32 (Level 3): Out of memory while parsing parameter. 

REFERENCES 

SET-CURRENT-MATCHING-CLASS command 



ERRORS 

SA03 (Level 2): Command invalid at this time : the speci- 
fied segment is currently being defined. 

SA1 (Level 2): Segment does not exist. 

SA11 (Level 2): Invalid segment-number. (Must range 
from -3 to -1 , or from 1 to 32767.) 
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SET-SEGMENT-DETECTABILITY Command 7-329 

SET-SEGMENT-DISPLAY-PRIORITY Command 7-331 

SET-SEGMENT-HIGHLIGHTING Command 7-332 

SET-SEGMENT-IMAGE-TRANSFORM Command 7-334 

SET-SEGMENT-POSITION Command 7-337 

SET-SEGMENT-VISIBILITY Command 7-339 

SET-SEGMENT-VVRiTiNG-MODE Command 7-341 

SET-SNOOPY-MODE Command 7-344 

SET-STOP-BITS Command 7.345 

SET-SURFACE-COLOR-MAP Command 7-346 

SET-SURFACE-DEFINITIONS Command 7-349 
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SET-SEGMENT-DETECTABILITY Command 



Host Syntax 



E cSD \n\:segment-number \n\:detectability 



Setup Syntax 



E cSD s p segment-number detectability 



PARAMETERS 

segment-number (-3 to -1 , 1 to 32767). 

Names the segment whose detectability mode is being 
set. 

-3 all segments that match the current match- 

ing class 

-2 the default for segments yet to be defined 

-1 all segments 

the crosshair cursor 

1 to 32767 a specific segment 

detectability (0 or 1). 

Specifies whether a segment can be picked in a GIN 
"pick" operation or not. 

can't be picked 

1 can be picked 



nCC^DIDTIAM 

This command sets the detectability of a segment. If a 
detectability of 1 is specified, and the segment is visible in 
the current view, it may be picked when the pick function is 
enabled. If is specified, the segment may not be picked. 



Segment-Number Parameter. The segment number may 
be a positive number, or any of the special negative num- 
bers 0, -1 , -2, and -3. A positive number refers to a specific 
single segment, previously defined with BEGIN-SEGMENT 
and END-SEGMENT commands. Detectability can be spec- 
ified for Segment 0, but it is not set (that is, the crosshair 
cursor is not detectable). Segment -1 means all segments. 
Segment -2 means default for segments not yet defined. 
Segment —3 means a!! segments that match the current 
segment matching class. 

The default segment detectability is 1 (detectable), unless 
the detectability for segment -2 has been set to (non- 
detectable), in which case, the default detectability is 0. 

All vectors, text, and markers are "pickable". On 41 12, 
4113, and 41 1 5 terminals, only the center point of a marker 
is pickable. The filled portion of a panel is also pickable on 
these terminals. 
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DEFAULTS ERRORS 

segment-number SD03 (Level 2): Command is invalid at this time. (The 

as shipped — none specified segment is currently being 

on power-up — none defined.) 

if omitted — error SD11 «„..„ , „> „ 

SD10 (Level 2): Segment does not exist. 

detectability SD11 (Level 2): Invalid segment-number (must range from 

as shipped — 1 -3 to 32767). 

if omitted"— 0~ ^ SD21 < Level2 ) : Invalid detectaM/fy (must be or 1). 

REFERENCES 

ENABLE-GIN command 
SET-CURRENT-MATCHING-CLASS command 
SET-SEGMENT-CLASS command 
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SET-SEGMENT-DISPLAY-PRIORITY Command 



Host Syntax 



E cSS \n\:segment-number m\:priority-number 



Setup Syntax 



E cSS s p segment-number priority-number 



OADAMCTCDC 
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segment-number (-3 to -1 , or 1 to 32767). 

Names the segment for which a display priority is being 
set. 

-3 all segments that match the curreni match- 

ing class 

-2 the default for segments yet to be defined 

-1 all segments 

1 to 32767 a specific segment 

priority-number (-32768 to 32767). 

Specifies the display priority of the specified segment. 

DESCRIPTION 

This command sets the display priority of the specified 
segment. (The display priority number may be any integer in 
the range from -32768 to 32767.) 

NOTE 

During a graphic input pick operation, the display 
priority of segments affects which of several eligible 
segments will be picked. (An eligible segment is a 
visible, detectable segment, part of which falls 
within the current pick aperture.) Of eligible seg- 
ments, the one with the highest priority is the one 
that will be picked. 

On power-up, the default priority for new segments is 0, 
unless the display priority for segment -2 is set to a different 
number by SET-SEGMENT-DISPLAY-PRIORITY command. 



Upon redisplay (that is, when an invisible segment is made 
visible, or when a view is renewed), the segments are dis- 
played in priority order, so that the segment(s) last displayed 
are those with the highest display priority. 

For segments which are assigned the same display priority 
number, the order of display and the order of picking are not 
defined, and may be different on different Tektronix termi- 
nals. 



DEFAULTS 

segment-number 
as shipped — none 
n power-up — none 
if omitted — error SS1 1 

priority-number 
as shipped — 
on power-up — if omitted — 



ERRORS 

SS03 (Level 2): Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

551 (Level 2): Segment does not exist. 

5511 (Level 2): Invalid segment-number (must range from 

-3to-1,orfrom1 to 32767). 

SS21 (Level 2): Invalid priority-number (must range from 
-32768 to 32767). 



REFERENCES 

ENABLE-GIN command 
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SET-SEGMENT-HIGHLIGHTING Command 



Host Syntax 



E cSH inV.segment-number \n\:highlighting 



Setup Syntax 



E cSH s p segment-number highlighting 



PARAMETERS 

segment-number (-3 to -1 , or 1 to 32767). 

Names the segment for which highlighting is being spec- 
ified. 

-3 all segments that match the current match- 

ing class 

-2 the default for segments yet to be defined 

-1 all segments 

1 to 32767 a specific segment 

highlighting (0 or 1). 

Specifies whether a segment is highlighted (blinks) or 
not. 

turns off the blink feature 

1 turns on the blink feature 



DESCRIPTION 

Highlighting a segment makes it blink by turning the illumi- 
nated pixels off and on. 



On a 41 1 2, 41 1 3, or 41 1 5, if a highlight mode of 1 is speci- 
fied, the segment is blinked on and off at a slow rate. Then, 
after this has been done for all the segments which are 
being highlighted, the process is repeated, so the the seg- 
ments being highlighted appear as they did before. If the 
framing box is enabled, it is made invisible while the high- 
lighted segments are being redrawn (i.e., the framing box 
blinks, too) 

On the 41 12, 41 13, or 41 15, segment highlighting is per- 
formed regardless of the current fixup level. 

NOTE 

If there are many segments, or complex segments 
with many pixels, the highlighting process in the 
4112 or 41 13 may be very slow. In that case, you 
may find it advantageous not to use the SET-SEG- 
MENT-HIGHLIGHTING command. Instead, you 
can place the segments to be highlighted in a differ- 
ent view with a viewport on another surface, and 
blink that surface with the SET-SURFA CE- VISI- 
BILITY: 2 command. 



On a 41 1 4 or 41 1 6, if a highlight of 1 is specified, the speci- 
fied segment is blinked on and off in Refresh at a slow rate. 
If is specified, the blinking stops. 
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Setting the second parameter in the SET-SEGMENT-HIGH- 
LIGHTING command to zero turns off the highlighting fea- 
ture for the specified segment. The default is no 
highlighting. 

An opern segment does not blink, but will start blinking 
when it is closed. 



DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — error SH1 1 

highlighting 
as shipped — 
on power-up — 
if omitted — 



ERRORS 

SH03 (Level 2): Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

SH10 (Level 2): Segment does not exist. 

SH1 1 (Level 2): Invalid segment-number (must range from 
-3 to -1 , or from 1 to 32767). 

SH21 (Level 2): Invalid highlighting (must be or 1). 



REFERENCES 

SET-FIXUP-LEVEL command 
SET-SURFACE-VISIBILITY command 
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SET-SEGMENT-IMAGE-TRANSFORM Command 



Host Syntax 



E cSI mtsegment-number reaV.x-scale-factor xeaV.y-scale-factor real.rotation-angle xy.position 



Setup Syntax 



E cSl s p segment-number x-scale-factor y-scale-factor rotation-angle position 



PARAMETERS 



DESCRIPTION 



segment-number (-3 to -1 , or 1 to 32767). 

Names the segment for which an image transform is 
being specified. 

-3 all segments that match the current match- 

ing class 

-2 the default for segments yet to be defined 

-1 all segments 

1 to 32767 a specific segment 

x-scale-factor (-32767.0 to + 32767.0). 

The factor by which the segment is scaled in the x-direc- 
tion. 

y-scale-factor (-32767.0 to + 32767.0). 

The factor by which the segment is scaled in the y-direc- 
tion. 

rotation-angle (-32767.0 to + 32767.0). 

The counterclockwise rotation angle, in degrees. (A 
negative number specifies a clockwise rotation.) 



)to 



position (41 1 2, 41 1 3, 41 1 4, 41 1 6: X = to 4095, Y = 0L 
4095; 411 5: X = -2 31 to 2 31 -1 , Y = -2 31 to2 31 -1). 
The position in terminal space where the segment's pivot 
point is to be located. 



The SET-SEGMENT-IMAGE-TRANSFORM command trans- 
forms the segment as follows: 

1 . First, the segment is scaled in the x- and y-directions by 
the amounts specified by the x and y scale factors. A 
negative scale factor indicates an inversion about the 
appropriate axis. 

2. Next, the segment is rotated counterclockwise about its 
pivot point by the number of degrees specified in the 
rotation parameter. If this parameter is negative, then 
the segment is rotated clockwise. 

3. Finally, the segment is moved (translated) so that its 
pivot point is at the position specified by the position xy 
parameter. 

Image transform operations are not cumulative. They 
always start at the size and position of the segment as origi- 
nally defined. 
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In the 41 1 4 and 41 1 6, if a segment is visible, the operator 
can immediately see the effect of a SET-SEGMENT-IMAGE- 
TRANSFORM command. In the 41 1 2, 41 1 3, and 41 1 5, 
however, the current fixup level determines how soon the 
display is updated to show the new position of the trans- 
formed segment. (See SET-FIXUP-LEVEL for details.) If the 
fixup level is less than two, then the effect of the new image 
transform cannot be seen until the next PAGE or RENEW 
command, or the next depression of the PAGE, VIEW, 
OVERVIEW, or RESTORE keys. 



Segment Number. A segment-number in the range from 1 to 
32767 specifies one particular segment. Segment -1 
means all segments currently defined, while segment -3 
means all segments that match the current segment match- 
ing class. (The current matching class is determined by the 
most recent SET-CURRENT-MATCHING-CLASS corn- 



Specifying segment-number is not allowed. (Segment 
refers to the crosshair cursor, which cannot be rotated or 
scaled. If you want to change the position of segment 0, use 
the SET-SEGMENT-POSITION command.) 

Segment-number -2 means default for segments not yet 
defined. You can set the image transform parameters for 
segments which have not yet been defined. However, on a 
41 1 2 or 41 1 3, if the xand y-scale factors are not unity, if the 
rotation angle is not zero, or if the position parameter is not 
the same as the current pivot point, then a segment being 
defined will not be displayed until an END-SEGMENT com- 
mand terminates the segment definition. The SET-PIVOT- 
POINT command changes the default position for the 
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point. 



If a segment is being used as the graphic cursor for a GIN 
operation, moving that segment with the SET-SEGMENT- 
IMAGE-TRANSFORM command does not change the cur- 
rent graphic input location. The next time the operator 
moves the thumbwheels (or other GIN device), the graphic 
input location is changed and the segment's pivot point is 
moved to that new graphic input location. 

If a segment's position is changed by the SET-SEGMENT- 
POSITION command, or by using the segment as a graphic 
input cursor, then the position of the current image trans- 
form for that segment is updated to reflect the change (the 
scale and rotation are not affected). 

DEFAULTS 

segment-number 
as Snipped — none 
on power-up — none 
if omitted — error Si11 

x-scale-factor 

as shipped — 1 .0 
on power-up — 1.0 
if omitted — 0.0 

y-scale-factor 
as shipped — 1 .0 
on power-up— 1.0 
if omitted — 0.0 

rotation-angle 
as shipped — 0.0 
on power-up — 0.0 
if omitted — 0.0 



4114 and 41 16 Clipping. After the scaling, rotation, and 
positioning has occurred, parts of the segment whose x- or 
y-coordinates are outside the range from to 4095 are 
clipped (made invisible). 



position 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 



On a 41 1 2, 41 1 3, or 41 1 5, after the scaling, rotation, and 
positioning has occurred, any parts of the segment which 
extend outside the current window will not be displayed. 
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ERRORS 



REFERENCES 



SI03 Level 2); 



SI02 Level 3) 



SI10 


Level 2) 


SI11 


Level 2) 


SI21 


Level 2) 


SI31 


Level 2) 


SI41 


Level 2) 


SI51 


Level 2) 



Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

Out of memory while transforming seg- 
ment. 

Segment does not exist. 

Invalid segment-number (must range from 
-3 to -1 , or 1 to 32767). 

Invalid x-scaling-f actor. (Must range from 
-32767.0 to 32767.0) 
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-32767.0 to 32767.0) 

Invalid rotation-angle. (Must range from 
-32767.0 to 32767.0) 

Invalid position (4112,411 3, 41 14,411 6: 
X = to 4095, Y = to 4095; 41 15: X = 
-2 31 to2 31 -1,Y = -2 31 to2 31 -1). 



BEGIN-SEGMENT command 
SET-PIVOT-POINT command 
SET-SEGMENT-POSITION command 
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Host Syntax 



E cSX M:segment-number xy.position 



Setup Syntax 



E cSX s p segment-number position 



DA DAMCTCDC 

segment-number (-3 to 32767). 

Names the segment whose position is being specified. 

-3 all segments that match the current match- 

ing ciass 

-2 the default for segments yet to be defined 

-1 all segments 

the crosshair cursor 

1 to 32767 a specific segment 

position (41 1 2, 41 1 3, 41 1 4, 41 1 6: X = to 4095, Y = to 
4095; 4115: X = -2 31 to 2 31 -1 , Y = -2 31 to2 31 -1). 
The position in terminal space where the segment's pivot 
point is to be located. 

DESCRIPTION 

The segment specified by the first parameter is moved so 
that its pivot point is at the location specified by the second 
parameter. 

A segment number in the range from 1 to 32767 specifies a 
segment which has previously been defined with BEGIN- 
SEGMENT and END-SEGMENT commands. An error is 
detected if the specified segment does not exist. 

Segment refers to the crosshair graphic cursor. Segment 
-1 means all currently defined segments (with numbers 
from 1 to 32767). Segment -3 means all segments that 
match the current segment matching class. 



Segment -2 means "the default for segments yet to be 
defined." Normally, when a segment is defined, its position 
is set to the same location as its pivot point (set by the most 
recent SET-PIVOT-POINT command). However, you can 
issue a SET-SEGMENT-POSITION : -2, (x,y) command in 
which (x,y) is a different location from the current pivot 
point. If you do this on a 41 1 4 or 41 1 6, however, a segment 
being created is not displayed until after the end-segment 
command that terminates the segment definition. 

The SET-PIVOT-POINT command changes the default 
position for "segments not yet defined" to be the same as 
the new pivot point. 

On a 41 1 4 and 41 1 6, if part of the segment goes off the right 
or left edge of the screen (X > 4095 or X < 0), that part of 
the segment will not be displayed. 

Segment vectors that go higher than Y = 3071 , or lower than 
Y = 0, stop being visible only when the edge of the display is 
incountered. The exact Y coordinates (outside the normal 
to 3071 range) where the vectors become invisible will vary 
during terminal usage; therefore, host programs should not 
rely on knowing these exact values. 

On a 41 12, 4113, or 41 15, if part of a segment extends 
outside the current window, then that part of the segment is 
not displayed. 

A segment's position may also be changed by the SET- 
SEGMENT-IMAGE-TRANSFORM command, or by using 
the segment as the graphic input cursor. 
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If the segment specified is being used as the graphic cursor 
in a GIN operation, then the segment's position is changed 
by the SET-SEGMENT-POSITION command, but the cur- 
rent graphic input location is not updated. The graphic input 
location will be updated and the segment serving as the 
graphic cursor will be moved the next time the operator 
moves the thumbwheels (or other graphic input device). 



DEFAULTS 



segment-number 
as shipped — none 
on power-up — none 
if omitted — 



ERRORS 

SX02 (Level 3): Out of memory. 

SX03 (Level 2): Command is invalid at this time: the spec- 
ified segment is currently being defined. 
(41 12, 41 13, 41 15 only) 

SX1 (Level 2): Segment does not exist. 

SX1 1 (Level 2): Invalid segment-number (must range from 
-3 to 32767.) 

SX21 (Level 2): Invalid position (41 12, 4113,4114, 4116: 
X = 0to4095,Y = to 4095; 411 5: X = 
-2 31 to 2 31 -1 , Y = -2 31 to2 31 -1). 



position 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 



REFERENCES 

SET-CURRENT-MATCHING-CLASS command 
SET-PIVOT-POINT command 
SET-IMAGE-TRANSFORM command 
SET-WINDOW command 
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Host Syntax 



E cSV mV.segment-number mXwisibility 



Setup Syntax 



E cSV s p segment-number visibility 



PARAMETERS 

segment-number (-3 to 32767). 

Names the segment whose visibility is being specified. 

-3 all segments that match the current match- 

ing class 

-2 the default for segments yet to be defined 

-1 all segments 

the crosshair cursor 

1 to 32767 a specific segment 

visibility (0 or ~\). 

Specifies whether a segment is visible in the current view 
or not. 

makes segment invisible 

1 makes segment visible 

DESCRIPTION 

41 12, 41 13 or 41 1 5. On a 41 1 2, 41 1 3 or 41 15, the visibility 
attribute of the specified segment (or segments) is set to 
"visible" or "invisible." If a visibility of 1 is specified for a 
segment in the current view, the segment appears in the 
mode specified by the most recent SET-SEGMENT-WRIT- 
ING-MODE command for that segment. 



If a visibility of is specified, the segment is made invisible, 
either immediately or the next time the screen is erased, 
depending on the fixup level specified In the most recent 
SET-FIXUP-LEVEL command. 

In the 4112,4113 and 4115, segments are only automati- 
cally visible in the view in which they are created. That is, 
segment visibility is "local" to the view. However, segments 
themselves are "global" to all views. That is, they exist in all 
views, but must be made visible explicitly in any view other 
than the one in which they are created. 

Segment 0, the hardware-drawn crosshair cursor, is visible 
in all views after it is made visible in one view. 

Here, "the view in which a segment is created" means "the 
view which was selected at the time of the END-SEGMENT 
command which terminated the segment definition." 



4114 or 41 16. On a 41 14 or 41 16, the visibility attribute of 
the specified segment is set to "visible" or "invisible". If a 
visibility of 1 is specified, the segment appears immediately. 

If a visibility of is specified, the segment is removed imme- 
diately from the display if it was displayed in refresh mode; 
otherwise it is removed the next time the display area is 
erased. 



Default Visibility. In all terminals, the default for new seg- 
ments is visible. This may, however, be altered by a SET- 
SEGMENT-VISIBILITY command for segment - 2. 
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Segment Number. A segment number in the range from 1 
to 32767 applies to one particular segment. (If that segment 
is not present, then the terminal detects an error.) "Segment 
0" means the graphic crosshair cursor. Segment numbers 
-1,-2, and -3 refer, respectively, to "all segments," "all 
segments not yet defined," and "all segments that match 
the current segment matching class." 

NOTE 

When GIN is enabled, the terminal saves the visibil- 
ity attribute for the segment which is to be used as 
the graphic cursor. That segment is then made 
visible. When GIN is disabled, the saved value of 
the visibility attribute is restored to the segment 
which acted as the graphic cursor. 

Therefore, any SET-SEGMENT-VISIBILITY 
commands, which may be issued for the graphic 
cursor while GIN is enabled, will cease to have 
effect when GIN is disabled. 



ERRORS 

SV02 (Level 3): Out of memory (41 12, 4113, 41 15 only) 

SV03 (Level 2): Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

SV1 (Level 2): Segment does not exist. 

SV1 1 (Level 2): Invalid segment-number (must range from 
-3 to 32767). 

SV21 (Level 2): Invalid visibility (must be or 1 ). 

REFERENCES 

SET-PIVOT-POINT command 



DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — 

visibility 

as shipped — 1 
on power-up — 1 
if omitted — 
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SET-SEGMENT-WRITING-MODE COMMAND 



Host Syntax 



E cSM m\:segment-number \ntwriting-mode 



Setup Syntax 



E cSM s p segment-number writing-mode 



PARAMETERS 



segment-number (-3 to 32767). 

Names the segment for which a writing mode is being 
specified. 

-3 all segments that match the current match- 

ing class 

-2 the default for segments yet to be defined 

-1 all segments 

the crosshair cursor 

1 to 32767 a specific segment 

writing-mode (41 1 2, 41 1 3, 41 1 4, 41 1 6: 1 or 2; 
4115:1 to 4). 
In the 41 14 and 41 1 6, mode 1 is "Storage mode;" when 
a segment is displayed, it is stored in the phosphor of the 
terminal's direct-view storage tube. In the 41 1 2, 41 1 3 
and 41 15, mode 1 is "Set mode;" displaying a segment 
sets pixels in raster memory space to exactly those color 
indices used in the segment definition. 

In the 41 14 and 41 16, mode 2 is "Refresh mode;" a 
segment is not stored in the tube's phospher, but instead 
is refreshed continually by re-traversing all the lines of 
the segment. If the terminal is equipped with Option 31 , 
the segment appears orange rather than green. In the 
4112,4113 and 4115, mode 2 is "XOR mode;" display- 
ing a segment causes a bit-by-bit XOR operation to be 
performed on pixels at which the segment is displayed. 

On the 4115, mode 3 is AND mode, and mode 4 is OR 
mode. AND mode causes a bit-by-bit AND operation on 
the pixels at which the segment is displayed. OR mode 
causes a bit-by-bit OR operation on the pixels at which 
the segment is displayed. 



4112, 4113, and 41 15 Terminals 

This command specifies the writing mode that is used when 
displaying the specified segment. More precisely, it deter- 
mines the writing mode used when writing an image of the 
segment into a viewport on a writing surface in raster mem- 
ory space. 

Valid segment-numbers are -1 ("all segments"), -2 ("default 
for segments not yet defined"), -3 ("all segments in the 
current segment matching class"), and particular segment- 
numbers in the range from 1 to 32767. Errors are detected if 
a segment-number tor a nonexistent segment is specified. 
Specifying segment zero (the cr 
error, but does not result in any action. 
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If the segment-number is -2 ("default for new segments"), 
this command also sets the writing mode for the following: 

• Alphatext sent to the graphic area. (That is alphatext 
sent to the terminal when the dialog area is disabled. 

• Graphtext. 

• Lines (vectors), markers, and panels. 



Mode 1 (Set Mode). As an image of the segment is written 
into the current viewport, each pixel being written over is set 
to the appropriate color index. The color index is the current 
line index for pixels which form the image of lines or 
graphtext, and the current text index for pixels which make 
up characters of alphatext or graphtext. The previous color 
index stored in the pixel is destroyed. 
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Mode 2 (XOR Mode). As an image of the segment is written 
into the current viewport, each pixel being written over is 
replaced by a pixel in a new color index. The new color 
index is a binary number which is the bit-by-bit "exclusive 
OR" of the bits in the old color index for that pixel and the 
corresponding bits of the current line index or text index. 

This XOR (exclusive OR) mode is convenient for writing 
images which may later need to be erased or re-positioned 
on the screen. If a segment defines a given pixel to the 
same value twice (such as crossing lines), it is as if the pixel 
were not defined. This is because a line (or alphatext char- 
acter, etc.) can be erased by writing over it again in XOR 
mode. (This property is a consequence of the Boolean logic 
theorem that (A XOR B) XOR B = A.) 

When the fixup level is set to 4, changing a segment's writ- 
ing mode from Set to XOR causes the segment to disap- 
pear. Renewing the view causes the segment to reappear. 



If the segment specified is currently being used as a graphic 
cursor, then the SET-SEGMENT-WRITING-MODE com- 
mand does not take effect until the current GIN (graphic 
input) operation is disabled. 

NOTE 

In the 4112, 4113, and 4115 terminals, it is prudent, 
after changing a segment's writing mode, to issue a 
PAGE or RENEW- VIEW command. This ensures 
that the viewport is updated to display the segment 
properly. 

If you fail to do this, and the current fixup level is 
five or more, it is possible that repositioning a 
segment may cause it to appear in more than one 
location on the screen. The remedy is for the host 
to issue a PA GE or RENE W- VIE W command, or 
for the operator to press the PA GE key. 



Mode 3 (AND Mode; 41 1 5 only). As an image of the seg- 
ment is written into the current viewport, each pixel being 
written over is replaced by a pixel in a new color index. The 
new color index is a binary number which is the bit-by-bit 
AND of the bits in the old color index for that pixel and the 
corresponding bits of the current line index or text index. 



Mode 4 (OR Mode; 4115 only). As an image of the segment 
is written into the current viewport, each pixel being written 
over is replaced by a pixel in a new color index. The new 
color index is a binary number which is the bit-by-bit OR of 
the bits in the old color index for that pixel and the corres- 
ponding bits of the current line index or text index. 



4114 and 4116 Terminals 

This command determines whether a segment is to be 
displayed in storage or refresh mode. 

Valid segment-numbers are -1 ("all segments"), -2 ("default 
for segments not yet defined"), -3 ("all segments that 
match the current segment matching class"), and particular 
segment-numbers in the range from 1 to 32767. Errors are 
detected if segment zero is specified, or if a segment-num- 
ber for a nonexistent segment is specified. 



Mode 1 (Storage Mode). The segment will be displayed in 
storage mode. If currently visible and being displayed in 
refresh mode, the refresh image disappears and the seg- 
ment is re-drawn in storage mode. 



7-342 



41 10 SERIES COMMAND REFERENCE 



TEK COMMANDS 



Mode 2 (Refresh Mode). The segment will be displayed in 
refresh mode. If the segment is already visible in storage 
mode, the refresh image will appear superimposed upon 
the storage mode image; later, after the screen is erased, 
the only the segment's refresh-mode image will be visible. 
On power-up, the default display mode for all segments is 
mode 1 (storage mode). 

If the segment specified is currently being used as a graphic 
cursor, then the SET-SEGMENT-WRITING-MODE com- 
mand does not take effect until the current GIN (graphic 
input) operation is disabled. 



DEFAULTS 

segment-number 
as shipped — none 
on power-up — none 
if omitted — 

writing-mode 
as shipped — 1 
on power-up — 1 
if omitted — error SM21 



ERRORS 

SM03 (Level 2): Command is invalid at this time. (The 
specified segment is currently being 
defined). 

SM10 (Level 2): Segment does not exist. 

SM1 1 (Level 2): Invalid segment-number (must range from 
-3 to 32767). 

SM21 (Level 2): Invalid writing-mode (must be 1 or 2). 



REFERENCES 

BEGIN-PIXEL-OPERATIONS command 
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SET-SNOOPY-MODE Command 



Host Syntax 



E cKS \nt:snoopy-mode 



Setup Syntax 




PARAMETERS 

snoopy-mode (0 or 1 ). 

Specifies wheter the terminal is to be in or out of Snoopy 
mode. Setup mode parameters are YES and NO. 

NO; in Setup mode, a SNOOPY NO com- 
mand removes the terminal from Snoopy 
mode. (The terminal cannot be removed 
from Snoopy mode with the escape- 
sequence version of this command, because 
escape-sequence commands are ignored in 
Snoopy mode.) 

1 YES; puts the terminal in Snoopy mode. 



Only the operator can remove the terminal from Snoopy 
mode. The operator can do this in two ways: 

• The operator can press the CANCEL key; among other 
effects, this key removes the terminal from Snoopy 
mode. (See the descriptions of the CANCEL key and the 
CANCEL command for details.) 

• The operator can press the SETUP key to put the termi- 
nal in Setup mode. Then, while in Setup mode, the oper- 
ator would type the SNOOPY NO command. 

Typing SNOOPY NO in Setup mode not only removes the 
terminal from Snoopy mode, but also puts the terminal in 
Alpha mode. 



DESCRIPTION 

A SET-SNOOPY-MODE: 1 command puts the terminal in 
Snoopy mode. This lets the operator view control characters 
received from the host (or typed on the keyboard in LOCAL 
mode). 

Control characters such as E c, G s, u s, etc., are processed 
like any other printing ASCII character. (Each control char- 
acter has a corresponding Snoopy mode mnemonic charac- 
ter which is displayed on the screen.) The c r character, 
however, is not only displayed, but also advances the cursor 
to the start of the next line. 

It is impossible to execute commands from the host or the 
keyboard (except in SETUP mode) while Snoopy mode is in 
effect. 



DEFAULTS 

snoopy-mode 
as shipped — 
on power-up — 
if omitted — 1 



ERRORS 

KS11 (Level 2): Invalid snoopy-mode (must be or 1) 

REFERENCES 

CANCEL command 
CANCEL key 
SETUP key 
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SET-STOP-BITS Command 



TEK COMMANDS 



Host Syntax 



E cNB mtnumber-of-stop-bits 



Setup Syntax 



STOPBITS s p number-of-stop-bits 



PAR AM E 



i en; 



riCCA I II TO 

1/crAuLi 3 



number-of-stop-bits (1 or 2). 

Specifies the number of stop bits appended to each 
character transmitted from the terminal. 



DESCRIPTION 

This command specifies the number of stop bits appended 
to each character transmitted from the terminal to the host. 



number-of-stop-bits 
as shipped — 1 
on power-up — remembered 
if omitted — error NB1 1 



ERRORS 



NB11 (Level 2): Invalid number-of-stop-bits (must be 1 
or 2). 
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SET-SURFACE-COLOR-MAP Command 



4112,4113,4115 



Host Syntax 



E cTG mv.surface-number \r\t-array.color-mixtures 

\nt-array.color-mixtures = mtcount 

[quadruple...] 

quadruple = \vX\color-index 

i ntfirst-color-coordinate 

\nt:second-color-coordinate 

\n\:third-color-coordinate 



Setup Syntax 



CMAP s p surface-number color-mixtures 

color-mixtures = [quadruple...] 

quadruple = color-index 

first-color-coordinate 
second-color-coordinate 
th ird-color-coordinate 



PARAMETERS 

surface-number (41 12, 41 13: -1 , or 1 to 4; 41 15: -1 , or 
1 to 8). 
Names the surface for which color mixtures are being 
defined. -1 means a "super surface" consisting of all bit 
planes of all surfaces presently defined. 

color-mixtures array 

An array of int parameters, which are considered in 
groups of four (quadruples). The first int in each quadru- 
ple names a color index, while the following three ints 
specify the color mixture for that color index. The color 
mixture is specified in the HLS, RGB, CMY, or (41 1 5 
only) Machine RGB color coordinate system, according 
to the most recent SET-COLOR-MODE command. A 
blinking color can be specified by adding 1 000 to the 
third coordinate of an index. 



If the first int in a quadruple is 0, then the following three 
ints specify the color of the background which is behind 
all the writing surfaces. 

The valid ranges for the first, second, and third coordi- 
nates in each system are, respectively: 

HLS: 

-32767 to 32767; to 1 00; to 1 00 or 1 000 to 1 1 00 

RGB and CMY: 

Oto 100; Oto 100; 0to100or 1000 to 1100 

Machine RGB (41 1 5 only): 

to 255; to 255; to 255 or 1 000 to 1 255. 
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DESCRIPTION 



DEFAULTS 



The SET-SURFACE-COLOR-MAP command sets the "color 
map" for a particular surface. That is, it determines the 
mapping from that surface's color indices to particular color 
mixtures. 

This command also sets the surface gray levels to NTSC 
gray levels equivalent to the colors set using the following 
function: 

Gray level = 30% (Red level) + 59% (Green level) + 
11% (Blue level) 

The resulting gray level value is always rounded to the 
nearest integer. 

On a 41 1 2, any colors set with this command are displayed 
as gray levels that have been transformed with the above 
function. 

This command can be used to set the background color and 
background gray levels by setting the color of index 0. 

The effect of the SET-SURFACE-COLOR-MAP command 
continues until superseded by another SET-SURFACE- 
COLOR-MAP or SET-SURFACE-GRAY-LEVELS command, 
until surfaces are redefined with a SET-SURFACE-DEFINI- 
TIONS command, or until the terminal is reset (by the reset 
command or by pressing the RESET button) or turned off. 

In this command, surface -1 means a "super-surface" 
consisting of all bit planes in all surfaces presently defined. 
This is for use in advanced applications, such as controlling 
the exact color displayed where images on one surface 
overlap images on another surface, if you pian to use this 
"super-surface" feature, be sure to read Appendix D, which 
explains the super-surface and its side effects. 



The default colors for the 41 1 2 are equivalent to the default 
gray levels, with Hue and Saturation always 0, and Light- 
ness equal to the gray level. 

The SET-SURFACE-DEFINITIONS command sets the color 
mixture for each index on each surface to default values. 
The default colors are as follows: 



Color Index 


Color Mixture 


Color Coordinates 


Standard 41 13 




H 


L 


S 





Transparent 








1 


WHITE 





100 





2 


RED 


120 


50 


100 


3 


GREEN 


240 


50 


100 


4 


BLUE 





50 


100 


5 


CYAN 


300 


50 


100 


6 


MAGENTA 


60 


50 


100 


7 


YELLOW 


180 


50 


100 


41 13 with Option 


21 








8 


RED-YELLOW 










(ORANGE) 


150 


50 


100 


9 


GREEN-YELLOW 


210 


50 


100 


10 


GREEN-CYAN 


270 


50 


100 


11 


BLUE-CYAN 


330 


50 


100 


12 


BLUE-MAGENTA 


30 


50 


100 


13 


RED-MAGENTA 


90 


50 


100 


14 


DARK GRAY 





33 





15 


LIGHT GRAY 





67 






Appendix F lists the color coordinates in RGB mode of the 
256 default colors for the 41 15 terminal. 



Adding 1 000 to the third color coordinate of the index 
causes the color to blink by alternately becoming visible and 
invisible. For example, in the HLS color mode a normal red 
is indicated by (120,50,100), and a blinking red is given by 
(120,50,1100). 
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ERRORS 



REFERENCES 



TGOO (Level 0): Unrecognized command (4114 and 4116 
only). 

TG10 (Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 

TG11 (Level 2): \ma\\d surface-number. (Must be -1, or, 
for the 41 1 2 and 41 1 3, in the range from 1 
to 4; or, for the 41 15,1 to 8). 

TG21 (Level 2): Invalid color-mixtures array. (The array 
count must be a multiple of four in the 
range from through 65532. The first int 

i »"i *> "-i »"»!■• t~i wr* i i r™. r\f £<■» nr ! i»» + «-> nrt not l-tri f\ i^r *> 

ill CiUOl i ^iwup wi iUUi 1 1 I LtS iiiuOi u& U ul U 

color index in the range from 1 to 32767. 
The other three ints must be valid HLS, 
RGB, or CMY values, according to the 
most recent SET-COLOR-MODE com- 
mand. If the HLS system is in effect, the 
Hue parameter must be in the range from 
-32768 to 32767, while the Lightness and 
Saturation parameters must be in the 
range from to 100. If the RGB or CMY 
system is in effect, then the first two color 
coordinates must be in the range to 1 00, 
and the third color coordinate must be in 
the range from to 1 00 or 1 000 to 1 1 00. 
In a 41 1 5, if the Machine RGB system is 
in effect, the first two color coordinates 
must be in the range from to 255, and 
the third color coordinate must be in the 
range from to 255 or 1 000 to 1 255.) 

TG22 (Level 3): Out of memory while parsing parameter. 



Appendix D, The Super-Surface 
Appendix F, The 4115 Default Color Map 
SET-BACKGROUND-COLOR command 
SET-BACKGROUND-GRAY-LEVEL command 
SET-COLOR-MODE command 
SET-SURFACE-DEFINITIONS command 
SET-SURFACE-GRAY-LEVELS command 
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SET-SURFACE-DEFINITIONS Command 



4112,4113,4115 



Host Syntax 



E cRD \n\-array.surface-defs 

\r\l-anay.surface-defs = mtnumber-of-surfaces 

[surface-specifier. . . ] 

surface-specifier = \nV.number-of-bit-planes 



Setup Syntax 



E cRD s p surface-defs 

surface-defs = [surface-specifier...] 

surface-specifier = number-of-bit-planes 



PARAMETERS 

surface-defs 

An array of ints specifying the number of bit planes for 
each surface. The first int in the array (the array count) 
tells how many writing surfaces the terminal is to have. 
Subsequent ints specify the number of bit planes for their 
respective surfaces. 



DESCRIPTION 

The SET-SURFACE-DEFINITIONS command erases the 
screen and sets the number of bit planes in each surface. It 
also initializes the surface color map, the surface gray lev- 
els, surface priorities, and surface visibilities. On a 41 1 2 
and 41 1 3, if the dialog area surface is set to be visible, it is 
made visible as if a DAVIS YES command had been 
received. 

Here, the "number of bit planes" in each surface deter- 
mines the maximum color index which may be written into 
pixels on that surface. A surface with only one bit plane is 
allowed color indices and 1 only; a surface with two bit 
planes is allowed color indices 0, 1 , 2, and 3; while a surface 
with three bit planes is allowed any color index from to 7. 
In a 41 1 3, a surface with four bit planes is allowed any color 
index from to 1 5. In a 41 1 5, a surface with eight bit planes 
is allowed any color index from to 255. 



If more planes are specified than are installed in the termi- 
nal, an error is detected. 



Example. To assign one bit plane to surface one, and two bit 
planes to surface two, issue the following command: 



SET-SURFACE-DEFINITIONS: 
= E cRD int-array : (1,2) 
= E cRD int:2 int:1 int:2 



(1.2) 



In this example, surface 3 does not exist; an error will occur 
if you attempt to reference surface 3 in another command. 



Another Example. To assign one bit plane to surface 1 , zero 
bit planes to surface 2, and two bit planes to surface 3, issue 
the following command: 

SET-SURFACE-DEFINITIONS: (1,0,2) 
= E cRD int-array : (1,0,2) 
= E cRD int:3 int:1 int:0 int:2 
= E cRD3102 

In this example, surface 2 has zero bit planes. It is, however, 
possible to create a view whose viewport is on surface 2. In 
that case, nothing in that view would be visible on the 
screen. This may be useful for double buffering. Segments 
can be built in a view whose viewport is on a surface to 
which zero bit planes are assigned. Later, another SET- 
SURFACE-DEFINITIONS command can assign bit planes 
to that surface, and the segments become visible (when the 
view is renewed). 
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Initializing Gray-Levels (41 1 2 Terminal). In the 411 2 termi- 
nal, the SET-SURFACE-DEFINITIONS command also 
assigns a gray-level to each possible color index on each 
surface being defined. In all cases, color index is "trans- 
parent." The other color indices are assigned gray-levels as 
follows: 



For a one-bit-plane surface: 


Index 1 


= 


90% lightness 


For a two-bit-plane surface: 


Index 1 


= 


30% 




Index 2 


= 


60% 




Index 3 


= 


90% 


For a three-bit-plane surface: 


Index 1 


=r 


25% 




Index 2 


= 


30% 




Index 3 


= 


45% 




Index 4 


= 


60% 




Index 5 


= 


70% 




Index 6 


= 


85% 




Index 7 


= 


90% 



Initializing Surface Priorities. The SET-SURFACE-DEFINI- 
TIONS command assigns the following default priorities to 
the surfaces it defines. Surface one is in front; surface two, 
if it exists, is behind surface one; surface three, if it exists is 
behind surface two; and so on. You can change this order- 
ing with the SET-SURFACE-PRIORITIES command. 

DEFAULTS 

surface-defs 

as shipped — 1, 3, 4, 6, or 8 depending on the number 

of bit planes installed 
on power-up — 1 , 3, 4, 6, or 8 depending on the num- 
ber of bit planes installed if omitted — 
error RD1 1 



ERRORS 



Initializing Color-Mixtures (41 1 3 and 411 5 Terminals). In 

the 41 13 terminal, the SET-SURFACE-DEFINITIONS com- 
mand assigns a color mixture to each possible color index 
on each surface being defined: 



Color Index 


Color Mixture 


Color Coordinates 


Standard 41 13 




H 


L 


S 





Transparent 








1 


WHITE 





100 





2 


RED 


120 


50 


100 


3 


GREEN 


240 


50 


100 


4 


BLUE 





50 


100 


5 


CYAN 


300 


50 


100 


6 


MAGENTA 


60 


50 


100 


7 


YELLOW 


180 


50 


100 


41 13 with Option 21 








8 


RED-YELLOW 










(ORANGE) 


150 


50 


100 


9 


GREEN-YELLOW 


210 


50 


100 


10 


GREEN-CYAN 


270 


50 


100 


11 


BLUE-CYAN 


330 


50 


100 


12 


BLUE-MAGENTA 


30 


50 


100 


13 


RED-MAGENTA 


90 


50 


100 


14 


DARK GRAY 





33 





15 


LIGHT GRAY 





67 






Appendix F lists the color coordinates in RGB mode of the 
256 default colors for the 41 1 5 terminal. 



Initializing Visibility. The SET-SURFACE-DEFINITIONS 
command causes each surface it defines to be visible, as if 
a SET-SURFACE-VISIBILITY command were issued for that 
surface. 



RD00 (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 4113, or 41 15.) 

RD10 (Level 2): Occupied undefined surface. (This com- 
mand would have resulted in a dialog 
area viewport, pixel viewport, or num- 
bered graphic viewport residing on an 
undefined surface.) 

RD1 1 (Level 2): Invalid surface-defs array. 

41 12: the array count must range from 1 
to 3, and the ints in the array must range 
from to 3. 

41 1 3: the array count must range from 1 
to 4, and the ints in the array must range 
from to 4. 

41 1 5: the array count must range from 1 
to 8, and the ints in the array must range 
from to 8. 

RD1 2 (Level 3): Out of memory while trying to parse 
parameter. 

REFERENCE 

SET-SURFACE-COLOR-MAP command 
SET-SURFACE-GRAY-LEVELS command 
SET-SURFACE-PRIORITIES command 
SET-SURFACE-VISIBILITY command 
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Section 7 (cont) Page 

SET-SURFACE-GRAY-LEVELS Command 7-351 

SET-SURFACE-PRIORITIES Command 7-354 

SET-SURFACE-VISIBILITY Command 7-356 

SET-TABLET-HEADER-CHARACTERS Command 7-357 

SET-TABLET-SIZE Command 7-358 

SET-TABLET-STATUS-STRAP Command 7-359 

SET-TEXT-INDEX Command 7-350 

SET-TRANSM IT-DELAY Command 7-361 

SET-TRANSMIT-RATE-LIMIT Command 7-362 

SET-USER-NUMBER Command 7-363 

SET-VIEW-ATTRIBUTES Command 7-364 

SET-VIEW-DISPLAY-CLUSTER Command 7-366 

SET-VIEWPORT Command 7-368 

SET-WINDOW Command 7-370 

SET-4014-ALPHATEXT-SIZE Command 7-372 

SET-4014-LINE-STYLE Command 7-373 

SETUP Key 7-374 

s i Character 7-375 

s o Character 7-375 

SPOOL Command 7-376 
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SET-SURFACE-GRAY-LEVELS Command 



4112,4113,4115 



Host Syntax 



E cRG m\:surface-number mi-array.indices-and-gray-levels 



Setup Syntax 



E cRG s p surface-number indices-and-gray-levels 



PARAMETERS 

surface-number (41 1 2: 1 to 3; 41 1 3: 1 to 4; 41 1 5: -1 , 1 to 8). 
Names the surface for which gray-levels are being 
specified. 

indices-and-gray-levels. 

This array holds an even number of int parameters. The 
ints are considered in pairs, with the first int in each pair 
being a color index, and the second int in the pair speci- 
fying the gray-level (range to 1 00 and 1 000 to 1 1 00) for 
that color index. 



DESCRIPTION 

This command defines the color indices for a particular 
surface, assigning to each color index a corresponding 
shade of gray (gray-level). 



Color-Indices and Gray-Levels. Think of the color indices 
as ink bottles which can hold different shades of ink. Each 
writing surface has its own set of ink bottles, into which you 
can dip your pen when drawing lines on that surface. The 
number of ink bottles for a given surface is two raised to 
the power N, where N is the number of bit planes assigned 
to that surface by the SET-SURFACE-DEFINITIONS 
command. 



Ink bottle number (color index 0) always holds "ink eradi- 
cator." That is, whenever you draw a line in color index 0, 
that line is transparent, wiping out any previous line drawn 
on that surface. 

The SET-SURFACE-GRAY-LEVELS command loads differ- 
ent inks, in shades of gray (gray-levels) into a surface's ink 
bottles. Another command, SET-SURFACE-COLOR-MAP, 
lets you load colored inks as well as gray inks into the ink 
bottles. 

In the 41 1 2, there are fifteen distinct gray inks (shades of 
gray) which may be loaded into a surface's ink bottles with 
the SET-SURFACE-GRAY-LEVELS command. In the 41 13, 
sixteen distinct shades are available. In the 41 1 5, either 1 01 
shades or 256 shades are available. 

Specify a shade of gray with a number in the range from to 
100 or 1000 to 1100; this number is the "gray-level" coordi- 
nate used in the SET-SURFACE-GRAY-LEVELS command. 
This number corresponds to the "lightness" coordinate 
in the Hue-Lightness-Saturation (HLS) color coordinate 
system. 

If you want all areas displayed in a given gray-level to blink 
at 1 Vz cycles per second (alternate between visible and 
invisible), add 1 000 to the gray-level number in the indeces- 
and-gray-levels array. That is, if you want an index of gray- 
level 56 to blink, use 1 056 in the array instead of 56. The 
ranges for blinking gray-ievels are 1 000 to 1 1 00. 

Figure 7-23 shows the shades of gray available in the 41 1 2 
and the 41 13. 
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4112 



o 



95% — 100% 



88% — 94% 



81% — 87% 



75% — 80% 



68% — 74% 



61% — 67% 



54% — 60% 



48% — 53% 



41% — 47% 



34% — 40% 



27% — 33% 



21% — 26% 



14% — 20% 



7% — 13% 



0% — 6% 
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4113 



94% — 100% 



88% — 93% 



82% — 87% 



75% — 81% 



69% — 74% 



63% — 68% 



57% — 62% 



w 50% — 56% 

til -i 
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(5 J 44% — 49% 



38% — 43% 



32% — 37% 



25% — 31% 



19% — 24% 
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Figure 7-23. Shades of Gray Available in the 41 1 2 and the 4113. 
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The 41 15 gray-levels are not shown here due to the large 
number of levels available. 41 1 3 gray-level values are listed 
for the 41 1 3 shades shown in Figure 7-23, so that you can 
get some idea of the 41 1 5 gray-levels. 



Surface-Number Parameter. The first parameter is an int 
naming the writing surface for which gray-levels are being 
specified. That is, it names the surface whose ink bottles 
(color indices) are to be filled with various inks (shades 
of gray). 

In this command, surface -1 means a super surface of aii bit 
planes in all defined surfaces. 



Indices-and-Gray-Levels Parameter. The second of the 
command's parameters is an int-array holding pairs of 

m imknrn T^n ( I k^+ Mi imhar ir> oa^h r»oir ie a r*r\\r\r inHov 

HUM IUC/IO. 1 HO ill Ol HUll iW^i ll « *-"L*wm i i^iai i i^ u «wiw. >• .'wiwx, 

while the second number in the pair is a gray-level: a num- 
ber in the range from to 1 00. The gray-levels are the "per- 
centages of lightness" shown in Figure 7-23. They corre- 
spond to the "lightness" coordinate in the HLS color coordi- 
nate system. (See the description of the SET-SURFACE- 
COLOR-MAP command, and Appendix E, for more 
information on the 41 1 3's and 41 1 5's color coordinate 
systems.) 



DEFAULTS 

In the 41 12, inks in shades of gray are placed in each sur- 
face's ink bottles on power-up or when a SET-SURFACE- 
DEFINITIONS command is executed. These inks are as 
follows: 

One-Bit-Plane Surface 
Color Index Gray-Level 

Transparent (ink eradicator) 

1 90% (white) 

Two-Bit-Plane Surface 
Color Index Gray-Level 

Transparent (ink eradicator) 

1 30% (dark gray) 

2 60% (light gray) 

3 90% (white) 



Three-Bit-Plane Surface 
Color Index Gray-Level 






Transparent (ink eradicator) 


1 


25% 


2 


30% 


3 


45% 


4 


60% 


5 


70% 


6 


85% 


7 


90% (white) 



In the 41 13 and 41 15, colored inks are placed in each sur- 
faces's ink bottles on power-up or when a SET-SURFACE- 
DEFINITIONS command is executed. See the descriptions 
of the SET-SURFACE-DEFINITIONS and SET-SURFACE- 
COLOR-MAP commands for details. 



ERRORS 

RG00 (Level 0): 



Unrecognized command. (The terminal 
isnota4112,4113or4115.) 



RG1 (Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE- 
DEFINITIONS command). 

RG1 1 (Level 2): Invalid surface-number. (41 12: 1 to 3; 
4113:1 to4; 4115: -1,1 to 8.) 

RG21 (Level 2): Invalid indices-and-gray-levels array. (The 
array count must be even; the first int in 
each pair must be a color index in the 
range from 1 to 32767; the second int in 
each pair must be a valid gray-level: a 
number from to 100 and 1000 to 1 100). 

RG22 (Level 3): Out of memory while parsing parameter. 



REFERENCES 

COLOR-MAP command 
SET-BACKGROUND-COLOR command 
SET-BACKGROUND-GRAY-LEVEL command 
SET-SURFACE-DEFINITIONS command 
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SET-SURFACE-PRIORITIES Command 



4112,4113,4115 



Host Syntax 



E cRN M-array.priorities 



Setup Syntax 




PARAMETERS 

priorities. 

The ints in this array are grouped in pairs. The first int in 
each pair is a surface number, while the second int of the 
pair is a priority number for that surface. 

The ranges for surface numbers are: 

4112:1 to 3 
4113:1 to 4 
4115:1 to 8 



The ranges for priority numbers are: 



4112:0to4 
4113:0to5 
4115:0to9 



DESCRIPTION 

This command determines which of the transparent writing 
surfaces are "in front" of others, and which are "behind" 
other surfaces. 

Objects (especially filled areas) drawn on one surface will 
obscure objects drawn on a surface which is "behind" that 
surface if the SET-COLOR-MODE command's overlay- 
mode setting is OPAQUE rather than SUBTRACTIVE or 
ADDITIVE. 



Surface Priorities Array. The int-array parameter holds an 
even number of integers, which are regarded in pairs. The 
first integer in each pair is a surface number; the second 
integer in the pair is a priority number for that surface. Each 
surface is "in front of" all surfaces which have a larger 
priority number than it, and "behind" all surfaces which 
have lesser priority numbers. 

The resulting priorities, as are visible on the screen and 
reported in a terminal-settings-report, are determined by a 
combination of current priorities and the priorities set with 
this command. Surface priorities are set as follows: 

1 . The surfaces in the command are given their assigned 
priorities. 

2. All surfaces are assigned new priorities so that each 
surface has a unique priority, with the "front" surface 
having priority 1 . If two surfaces were assigned the 
same priority, the lower numbered surface is given the 
higher priority. 

For example, if the surfaces are defined with default priori- 
ties, and surface one is assigned priority 3, the result is that 
surface two has priority 1 , surface one has priority 2, and 
surface three has priority 3. 

Any surface can be put "in front" of all other surfaces by 
assigning it priority 0, or "behind" all other surfaces by 
assigning it priority one greater than the maximum number 
of possible surfaces for that terminal. 
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Example. Suppose we want surface 3 to be in front, and 
surface 2 in back, with surface 1 in between. Then surface 3 
should be assigned priority 1, surface 1 should be assigned 
priority 2, and surface 2 should be assigned priority 3. We 
would issue the following command: 

SET-SURFACE-PRIORITIES : surface 3, priority 1 ; 
surface 1 , priority 2; surface 2, priority 3 

= E cRN int-array : (3,1 ,1 ,2,2,3) 

= E cRN int:6 int:3 inf.1 int:1 int:2 int:2 int:3 

= E cRN6311223 



Special Cases. If two surfaces are assigned same priority, 
then the lower-numbered surface is deemed to be in front of 
the higher-numbered surface. If more than one priority is 
assigned to the same surface, then the last priority assigned 
that surface is the one which has effect. 



Default. When multiple surfaces are defined (with the SET- 
SURFACE-DEFINITIONS command), the surface priorities 
are: Surface 1 is the front surface; surface 2, if It exists, is 
behind surface 1 ; surface 3, if it exists, is behind surface 2; 
and so on. 



DEFAULTS 

priorities 

as shipped — 1,1 
on power-up — 1,1 
if omitted — error RN 1 1 



ERRORS 

RNOO (Level 0): Unrecognized command. (The terminal 
is not a 41 12, 41 13, or 41 15.) 

RN1 (Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE- 
DEFINITIONS command). 

RN1 1 (Level 2): Invalid priorities array (contents: 41 1 2: 
to4;4113:0to5;4115:0to9; 
count: to 65535). 

RN12 (Level 3): Out of memory while parsing parameter. 



REFERENCES 

SET-SURFACE-DEFINITIONS command 



On power-up only surface 1 exists. 
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SET-SURFACE-VISIBILITY Command 



Host Syntax 



E cRI \nt-array.surface-numbers-and-visibilities 



Setup Syntax 




PARAMETERS 

surface-numbers-and-visibilities. 

This int-array holds an even number of int parameters, 
which are regarded in pairs. 

The first int in each pair is a surface number. In the 41 1 2, 
this must be in the range from 1 to 3; in the 41 13, it must 
be in the range from 1 to 4; in the 41 15, it must be in the 
range from 1 to 8. 

The second int in each pair specifies the visibility mode, 
and must be in the range from to 2: 




1 
2 



invisible 

visible 

blinking (alternating) between visible and 
invisible 



DESCRIPTION 

This command changes the visibility of one or more sur- 
faces without affecting surface priorities or the visibility 
attributes of any segments in the surfaces. Normally, a 
surface is visible (visibility mode 1). If a surface is invisible 
(visibility mode 0), then no objects on that surface are dis- 
played; nor can segments displayed on an invisible surface 
be picked during a GIN operation. Visibility mode 2 causes 
a surface to "blink," or alternate between being visible and 
being invisible at 1 V2 cycles per second. Blinking indices 
and blinking surfaces blink in unison; highlighted segments 
do not necessarily blink in phase with each other or with 
other blinking graphic objects. 



This command is primarily for use in double buffering. It 
may also be used to provide an alternate, high-speed way 
to highlight segments. (Rather than issue a set-segment- 
highlighting command in order to cause a segment to blink, 
instead display the segment in a view whose viewport is on 
a blinking surface.) 

DEFAULTS 

surface-numbers-and-visibilities 
as shipped — 1,1 
on power-up — 1,1 
if omitted — error RI1 1 



ERRORS 

RI00 (Level 0): Unrecognized command. (The terminal 
isnota4112,4113,or4115.) 

RI10 (Level 2): A surface in surface-numbers-and- 

visibilities does not exist (has not been 
defined with a SET-SURFACE- 
DEFINITIONS command). 

RI11 (Level 2): Invalid surface-numbers-and-visibilities 
array. (Surface numbers: 41 12: 1 to 3; 
41 13: 1 to 4; 41 15: 1 to 8. Visibility: to 2 
for all terminals. Array count must be 
even and range from 2 to 65534.) 

RI12 (Level 3): Out of memory while parsing parameter. 

REFERENCES 

SET-SURFACE-DEFINITIONS command 
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SET-TABLET-HEADER-CHARACTERS Command 



OPTIONS 13, 14 



Host Syntax 



E clH mV.character-set-selector 



Setup Syntax 



TBHEADERCHARS s p character-set-selector 



PARAMETERS 

character-set-selector (0 or 1). 

Specifies whether letters or control characters are used 
as the header characters used in 4953-tablet-GIN- 
reports and the key characters used in GIN-stroke- 
reports. Setup mode parameters are LETTER and 
CONTROL. 

LETTERS; M, J, and O 

1 CONTROL; G s, s b, and u s 

DESCRIPTION 

This command selects the "header" characters used in 
4953-tablet-GIN-reports and the "key" characters used in 
GIN -stroke-reports. 



A SET-TABLET-HEADER-CHARACTERS: 1 command, 
however, can change these as follows: 

• 0, Z, 1 , 2, or 3 for the first point in a stroke. (These 
characters do not change.) 

• s b for subsequent points in a stroke. 

• u s for the last point in a stroke. 

For more details, see the GIN-stroke-report and 4953- 
tablet-GIN-report descriptions. 



DEFAULTS 

character-set-selector 
as shipped — 
on power-up — 
if omitted — 



Header Characters. If the parameter in the SET-TABLET- 
HEADER-CHARACTERS command is (the default), then 
the header characters in 4953-tablet-GIN-reports axe M, J, 
andO. 

If the parameter is 1 , then the header characters are G s, s b, 
and u s. 



ERRORS 

IH00 (Level 0): Unrecognized command. (Tablet option 
is not installed.) 

IH1 1 (Level 2): Invalid character-set-selector. (Must be 
or 1 ; in Setup mode, must be CONTROL 
or LETTERS.) 



Key Characters. If the parameter in the SET-TABLET- 
HEADER-CHARACTERS command is 0, then the key 
characters in GIN-stroke-reports are: 

• 0, Z, 1 , 2, or 3 for the first point in a stroke. The character 
M is used with the tablet pen, and the characters Z, 1 , 2, 
and 3 are used with the optional tablet cursor. 

• J for subsequent points in a stroke. 

• O for the last point in a stroke. 



REFERENCES 

ENABLE-GIN command 
ENABLE-4953-TABLET-GIN command 
GIN-stroke-report message type 
4953-tablet-GIN-report message type 
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SET-TABLET-SIZE Command 



OPTIONS 13, 14 



Host Syntax 




Setup Syntax 



TBSIZE s p tablet-size-mode 



PARAMETERS 

tablet-size-mode (0, 1 , or 2). 

Selects the size the active tablet area take when GIN is 
enabled. Setup mode parameters are AUTOMATIC, 
SMALL, and LARGE. 

AUTOMATIC; when the tablet is enabled 
with the ENABLE-GIN command, the larger 
active area is used. When the tablet is 
enabled with the ENABLE-4953-TABLET-GIN 
command, the smaller active area is used. 

1 SMALL; em ulates the 4953 and 4954 tablets 
used with earlier Tektronix terminals. The 
Option 1 3 tablet emulates the 4953 tablet 
(active area — 10.24 x 10.24 in. or 

260 x 260 mm). The Option 1 4 tablet 
emulate the 4954 tablet (active area — 
30.72 x 38.40 in. or 780 x 975 mm). 

2 LARGE; the Option 1 3 tablet has an active 
area of 1 1 x 1 1 in. or 279 x 279 mm. The 
Option 1 4 tablet has an active area of 

30 x 40 in. or 762 x 101 6 mm. 



DESCRIPTION 

This command sets the tablet size used during tablet GIN 
operations. 



In Large mode (tablet-size-mode = 2), the entire active 
areas of the Option 13 and 14 tablets are used. 

In Small mode (tablet-size-mode =1), since using the entire 
tablet area may cause problems when you are running 
applications programs developed for the earlier tablets, a 
slightly smaller portion of the tablet surface is used. Thus, 
Option 13 emulates the 4953 tablet and Option 14 emulates 
the 4954 tablet. 

In Automatic mode (tablet-size-mode = 0), Large or Small 
mode is automatically selected, according to whether you 
enable tablet GIN with the ENABLE-GIN command (Large 
mode) or the ENABLE-4953-TABLET-GIN command (Small 
mode). 

DEFAULTS 

tablet-size-mode 
as shipped — 
on power-up — 
if omitted — 

ERRORS 

IN00 (Level 0): Unrecognized command; Option 1 3 and/ 
or 14 firmware must be Version 2 or later. 

IN1 1 (Level 2): Invalid table-size-mode (must be 0, 1 , 
or 2). 



The graphic tablets included with Options 1 3 and 1 4 have 
slightly larger active areas than the TEKTRONIX 4953 and 
4954 tablets used with earlier Tektronix terminals. This 
command is included to emulate the earlier tablets more 
closely. 



REFERENCES 

ENABLE-GIN command 

ENABLE-4953-TABLET-GIN command 
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SET-TABLET-STATUS-STRAP Command 



OPTIONS 13, 14 



Host Syntax 



E clT mtstrap-setting 



Setup Syntax 



TBSTATUS s p strap-setting 



PARAMETERS 

strap-setting (0 or 1). 

This parameter emulates the STATUS strap on a TEK- 
TRONIX 4953 or 4954 tablet controller board. Setup 
mode parameters are STATUS OUT and STATUS IN. 

STATUS OUT 

1 STATUS IN 



DESCRIPTION 

This command helps a 41 10-series terminal emulate 
TEKTRONIX 401 0-series terminals which have accessory 
4953 or 4954 graphic tablets. The command emulates the 
STATUS strap on the 4953/4954 tablet controller board. 
(This strap controls whether not a terminal status byte is 
sent when the tablet pen is lifted away from the tablet.) 

NOTE 

This command only affects the 4953-tablet-status- 
reports sent to the host when the terminal has been 
enabled for graphic input with an ENABLE-4953- 
TABLET-GIN command. This command does not 
affect normal GIN operation with the EN ABLE- 
GIN command. 

If the parameter is 0, the terminal emulates the STATUS 
OUT setting of the 4953 tablet's STATUS strap. In this 
case, a status byte is not sent when the tablet pen leaves 
presence. 



If the parameter is 1 , the terminal emulates the STATUS IN 
strap setting. In this case, if the tablet has been enabled for 
"disable on leaving presence" mode, then a status byte is 
sent when the tablet pen leaves presence. 

For more information, see the description of the 4953-tablet- 
status-report. (See also the TEKTRONIX 4953/4954 
Graphics Tablet Instruction Manual.) 



DEFAULTS 

strap-setting 
as shipped — 1 
on power-up — 1 
if omitted — 1 



ERRORS 

IT00 (Level 0): Unrecognized command. (The tablet 
option is not installed.) 

IT1 1 (Level 2): Invalid strap-setting (must be or 1 ). 



REFERENCES 

ENABLE-4953-TABLET-GIN command 
4953-tablet-GIN-report message type 
4953/4954 Graphics Tablet Instruction Manual 
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SET-TEXT-INDEX Command 



Host Syntax 



E cMT \nX:text-index 



Setup Syntax 



E cMT s p text-index 



PARAMETERS 

text-index (0 to 32767). 

In the 41 12,411 3, and 41 1 5, this is the pen-index or 
color index used for subsequent alphatext and graph- 
text. In all terminals (including the 41 14 and 41 16), the 
text-index determines which pen is used when text in a 
segment is sent to a plotter. 

DESCRIPTION 



the most recent SET-TEXT-INDEX command. Those dots 
within the character cell which are not to be turned on 
(that is, the dots which form the background of the the char- 
acter cell) are written as set by the SET-GRAPHICS-AREA- 
WRITING-MODE or SET-BACKGROUND-INDEX 
commands. 

The SET-TEXT-INDEX command has no effect on alphatext 
in the dialog area. Instead, the appearance of dialog area 
text is governed by the SET-DIALOG-AREA-INDEX and 
SET-DIALOG-AREA-ALTERNATE-INDEX commands. 



The SET-TEXT-INDEX command specifies the color index 
(in the 41 1 2, 41 1 3, and 41 1 5) to be used for subsequent 
alphatext and graphtext. 



4114 and 41 1 6. In the 41 1 4 and 41 1 6, the text-index has no 
effect on the display. However, it does partially determine 
which plotter pen is used when a picture is copied to an 
accessory plotter with the plot command. (See MAP-INDEX- 
TO-PEN for details.) 



DEFAULTS 

text-index 

as shipped — 4112: 7 

4113,4115:1 
4114,4116:255 
on power-up — 4112:7 

4113,4115:1 
4114,4116:255 
if omitted — 



4112, 4113, and 4115. There is a maximum color index for 
any particular writing surface: one less than 2**M, where M 
is the number of bit planes assigned to that surface. (See 
SET-SURFACE-DEFINITIONS command.) If a text-index 
greater than the maximum is used, the 41 1 2, 4113, or 4115 
displays it as if it were the maximum color index for that 
surface. 

Dot matrix characters (characters of alphatext or string- 
precision graphtext) are written in the viewport of the cur- 
rent view as follows. Those dots within the character cell 
which are to be turned on (that is, the dots which form the 
character) are written using the current text index, as set by 



ERRORS 

MT1 1 (Level 2): Invalid text-index. (Must range from 
to 32767.) 



REFERENCES 

MAP-INDEX-TO-PEN command 
SET-DIALOG-AREA-INDEX command 
SET-SURFACE-DEFINITIONS command 
SET-VIEW-ATTRIBUTES command 
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Host Syntax 



E cND mttransmit-delay 



Setup Syntax 



XMTDELAY s p transmit-delay 



PARAMETERS 

transmit-delay (0 to 65535). 

The number of milliseconds which the terminal is to wait 
after sending each line of text before it starts transmitting 
the next line of text. 



DESCRIPTION 

This command sets the transmit delay. The transmit delay is 
the delay between when the terminal receives a prompt 
string or transmits an EOM-character and when the terminal 
sends data to the host. This command is used in conjunc- 
tion with Prompt mode, EOM-chars, and EOLstringsXo 
delay transmission from the terminal until the host is ready 
to accept. 

After sending one of the EOM-characters (set by the SET- 
EOM-CHARS command), the terminal pauses a short time 
before resuming transmission. The SET-TRANSMIT-DELAY 
time determines the duration of that "short time." 

The actual delay time may be up to 25 milliseconds greater 
than that specified, because of the resolution of the internal 
timer. 



If the terminal receives any characters after a prompt string, 
but before the transmit delay has elapsed, the prompt string 
is not recognized as such. 

DEFAULTS 

transmit-delay 
as shipped — 100 
on power-up — remembered 
if omitted — 

ERRORS 

ND11 (Level 2): Invalid transmit-delay. (Must range from 
to 65535 milliseconds.) 

REFERENCES 

ENTER-BYPASS-MODE command 

SET-EOM-CHARS command 

4110 Series Host Programmers Manual 
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SET-TRANSMIT-RATE-LIM1T Command 



Host Syntax 



E cNL mtrate-limit 



Setup Syntax 




PARAMETERS 

rate-limit (1 1 to 65535). 

Transmit rate limit, in bits per second. 



DESCRIPTION 

The SET-TRANSMIT-RATE-LIMIT command imposes an 
upper bound on how fast the terminal may send characters 
to the host computer. This may be useful in circumstances 
where the host cannot process characters as fast as the 
terminal can send them over the communications line. 



Example. Suppose the transmit baud rate (set by the SET- 
BAUD-RATES command) is 1 200 bits/sec — about 1 20 
characters per second. Suppose further that a SET- 
TRANSMIT-RATE-LIMIT: 300 command is sent to the ter- 
minal. Then, when transmitting characters to the host, the 
terminal will send each character at the full data rate (1 200 
bits/sec), but will space the characters apart so that the 
average bit rate is no more than 300 bits per second (about 
30 characters per second). 



DEFAULTS 

rate-limit 

as shipped — 19200 

on power-up — remembered 

if omitted — error NL1 1 



ERRORS 

NL1 1 (Level 2): Invalid rate-limit. (Must range from 1 1 
to 65535.) 



REFERENCES 

SET-BAUD-RATES command 
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SET-USER-NUMBER Command 
Host Syntax 



E cJU mV.user-number 



Setup Sytax 



USERNUMBER s p user-number 



PARAMETERS DEFAULTS 

user-number (0 to 1 5) . user-number 

The user number that the terminal should use when as shipped — 

accessing disk files. on power-up — 

if omitted — 

DESCRIPTION 

ERRORS 

This command tells the terminal to access only those files JU0Q Unrecognized command (firmware is 

marked with the user number specified by the user-number ^.^ g Qr ear|jer Qr djs|< js n(Jt 

parameter. It also marks all files subsequently created with installed) 



the same user number. 

If you request a directory list with the DIRECTORY com- 
mand, oniy those fiies with the current user-number axe 
reported. 



JU11 (Level 2): Invalid user-number (must be to 15). 
REFERENCES 



If you request a copy or spool operation of the entire con- COPY command 

tents of a disk, only those files with the current user-number DIRECTORY command 

are transferred. SPOOL command 
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SET-VIEW-ATTRIBUTES Command 



4112,4113,4115 



Host Syntax 



E cRA mV.surface-number \n\:wipe-index int: border-index 



Setup Syntax 



E cRA s p surface-number wipe-index border-index 



PARAMETERS 

surface-number (41 12: -1 to 3; 41 13: -1 to 4; 41 15: -1 to 8). 
Specifies the surface on which the view's viewport is 
located. -1 specifies the "super-surface." 

wipe-index (-1 to 32767). 

The color index used for wiping (erasing) the viewport. 

-1 viewport not erased 

to 32767 a specific index 

border-index (0 to 32767). 

The color index used for displaying a border around the 
viewport. 

DESCRIPTION 

This command sets the surface, wipe index, and border 
index for the current view. Here, "current view" means the 
view most recently selected with the SELECT-VIEW com- 
mand or the NEXTVIEW key. 



Surface Number. The first int parameter determines on 
which surface the view is to be displayed: that is, on which 
surface the viewport for that view exists. The default is 
surface 1 . 



If surface is specified, the current surface for the view is 
left unchanged. 

If surface -1 is specified, then a super surface is used. This 
super surface consists of all bit planes on all of the presently 
defined surfaces. The super surface is for use in advanced 
applications. If you plan to use the super surface, be sure to 
read Appendix D, which explains the super surface and its 
side effects. 

If a surface is specified which does not exist, then an error 
occurs. (A surface does not exist if it was not defined in the 
most recent SET-SURFACE-DEFINITIONS command.) 



Wipe Index. The second parameter specifies the wipe- 
index for the viewport of the specified view. This is the color 
index to which all pixels in the viewport are set during an 
erase operation. The default is color index 0, "transparent." 

If wipe-index\s -1 , the viewport is not erased during a page 
or renew operation. 

There is a maximum color index for any particular surface: 
one less than 2 M , where M is the number of bit planes 
assigned to that surface. If a wipe index greater than this 
maximum is specified, the terminal uses the maximum 
index as the wipe index. 
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Border Index. The third parameter specifies the color index 
in which the viewport border is to be drawn. (The border is 
drawn only if the BORDER key or SET-BORDER-VISIBILITY 
command has made the border visible.) 

If a border index greater than the maximum index for the 
surface is specified, the terminal uses the maximum index 
as the border index. 



DEFAULTS 

surface-number 
as shipped — 1 
on power-up — 1 
if omitted — 

wipe-index 

as shipped — 
on power-up — 
if omitted — 

border-index 

as shipped — 41 1 2: 8 

4113,4115:1 
on power-up — 41 12: 6 

4113,4115:1 
if omitted — 



ERRORS 

RAOO (LeveiO): unrecognized command. (The terminal 
is not a 41 12, 41 13 or 41 15.) 

RA10 (Level 2): Surface does not exist (has not been 
defined with SET-SURFACE- 
DEFINITIONS command). 

Invalid surface-number. (41 12: -1 to 3; 
4113: -1 to 4; 41 15: -1 to 8.) 



Invalid wipe-index. (Must range from 
-1 to 32767.) 

Invalid border-index. (Must range from 
to 32767.) 



RA11 (Level 2): 
RA21 (Level 2): 
RA31 (Level 2): 

REFERENCES 



BORDER key 

SET-BORDER-VISIBILITY command 
SELECT-VIEW command 
SET-SURFACE-DEFINITIONS command 
SET-SURFACE-COLOR-MAP command 
SET-SURFACE-GRAY-LEVELS command 
Appendix D, "The Super Surface." 
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SET-VIEW-DISPLAY-CLUSTER Command 



4112,4113,4115 



Host Syntax 



E cRQ \n\-array.view-numbers 



Setup Syntax 




PARAMETERS 



DESCRIPTION 



view-numbers. 

An array of int parameters, specifying which of the termi- 
nal's views are to be clustered together. Valid view num- 
bers are in the range from -2 to 64, as follows: 

-2 Removes from the current view's cluster any 

views which are currently in that cluster. 

-1 Clusters all 64 possible views together in one 

display cluster. Any views which may later be 
created (with the SELECT-VIEW command) 
will also be included in this display cluster. 

Refers to the current view, as selected by the 
most recent SELECT-VIEW command. 

1 to 64 Numbers from 1 to 64 name specific indi- 

vidual views. A view need not exist to be 
included in a view cluster. (Later, when the 
view is created with the SELECT-VIEW com- 
mand, it will be included in the view cluster). 

If the view-number int-array has a count of (i.e., is empty), 
then all views are removed from all view display clusters. 



In some circumstances, you may wish to have several views 
with identical windows for their window-viewport trans- 
forms. The SET-VIEW-DISPLAY-CLUSTER command lets 
you specify a list of views which are to have identical win- 
dows. Changing the window for any view in this "cluster" 
also changes the window for every other view in the cluster. 
Also, renewing any view in this cluster (RENEW-VIEW or 
PAGE command, or PAGE key) also renews every other 
view in the cluster. 

This is especially useful when you have several views on 
different surfaces, describing different aspects of the same 
object. For instance, suppose you are using the terminal as 
a light table for preparing multi-layered etched circuit board 
layouts. In that case, views one, two, three, and four might 
three, and four, respectively. View one would represent the 
top layer of a circuit board, while views two, three, and four 
would represent other layers of the same circuit board. In 
such an application, you would want the framing keys, and 
the SET-WINDOW and PAGE commands, to affect all four 
views. That way, when you use the framing keys to zoom in 
on a part of the picture, the zoom operation affects all four 
views, on all four surfaces. To accomplish this, you would 
cluster the four views together with the SET-VIEW-DISPLAY- 
CLUSTER command: 

SET-VIEW-DISPLAY-CLUSTER: (1 ,2,3,4) 

= E cRQ int-array: (1 ,2,3,4) 

= E cRQ41234 
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Thereafter, whenever you change the window for any one of 
these four views, the windows for the other three views also 
change. This happens whether you change the window 
explicitly, with the SET-WINDOW command, or implicitly, 
with the VIEW, CTRL-VIEW, RESTORE, CTRL-RESTORE, 
OVERVIEW, or CTRL-OVERVIEW keys. 

Likewise, whenever you renew any of these four views, all 
the other views in the cluster are also renewed. This hap- 
pens with the RENEW-VIEW and PAGE commands, and 
with the PAGE, VIEW, CTRL-VIEW, RESTORE, CTRL- 
RESTORE, OVERVIEW, and CTRL-OVERVIEW keys. 



Removing Ail Views From Only One Display Cluster. To 

remove all views from a single cluster, do the following: 

1 . Issue a SELECT-VIEW command to select one of the 
views in the cluster. 

2. Issue a SET-VIEW-DISPLAY-CLUSTER command 
containing the special view number, minus two: 

SET-VIEW-DISPLAY-CLUSTER: (-2) 

= E cRQ int-array: (-2) 

= E cRQ1 " 



Removing Specific Views from a Display Cluster. A view 
cannot belong to more than one display cluster. Thus, 
including a view in one cluster automatically removes it from 
any other clusters. Consider, for instance, the following 
commands: 



SET-VIEW-DISPLAY-CLUSTER 
SET-VIEW-DISPLAY-CLUSTER 
SET-VIEW-DISPLAY-CLUSTER 



(1,2,3,4) 
(3,4,5,6) 
(5,6,7) 



The first command creates a display cluster consisting of 
views 1,2,3, and 4. The second command creates a cluster 
with views 3, 4, 5, and 6; in doing so, it removes views 3 and 
4 from the first cluster. The third command creates a cluster 
with views 5, 6, 7, removing views 5 and 6 from the previous 
cluster as it does so. Thus, after all three commands have 
been executed, there are three display clusters, as follows: 
views 1 and 2; views 3 and 4; and views 5, 6, and 7. 



Removing All Views From All Clusters. If the SET-VIEW- 
DISPLAY-CLUSTER command's parameter is empty, then 
all views are removed from all clusters. That is, to remove all 
views from all clusters, issue the following command: 

SET-VIEW-DISPLAY-CLUSTER: empty array 

= E cRQO 



DEFAULTS 

When a view is first created, if it has not been specified by a 
previous SET-VIEW-DISPLAY-CLUSTER command, it is not 
clustered with any other views. When the terminal is pow- 
ered up or reset, no view is in any cluster. 

ERRORS 

RQOO (Level 0): Unrecognized command. (41 14 and 41 16 
only). 

RQ11 (Level 2): Invalid view-numbers array. (Each view 
number in the int-array must range from 
-2 to 64; count must be from to 65535.) 

RQ1 2 (Level 3): Out of memory while parsing parameter. 



REFERENCES 

DELETE-VIEW command 
OVERVIEW key 
PAGE command 
PAGE key 

RENEW-VIEW command 
RESTORE key 
SELECT-VIEW command 
VIEW key 
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SET-VIEWPORT Command 



4112,4113,4115 



Host Syntax 



E cRV xy.first-corner xy.second-corner 



Setup Syntax 



E cRV s p first-corner second-corner 



PARAMETERS 

first-corner (41 1 2, 41 1 3: X = to 4095, Y = to 3071 ; 
41 15: X = to 4095, Y = to 3276). 
Location of one corner of the current view's viewport, in 
normalized screen coordinates. 

second-corner (X = to 4095, Y = to 3071; 

4115:X = to 4095, Y = to 3276). 
Location of the opposite corner of the viewport, in nor- 
malized screen coordinates. 



DESCRIPTION 

This command sets the position of the current view's view- 
port in normalized screen coordinate space. 

The two xy parameters specify any two opposite corners of 
the viewport. 

In the 41 1 5, the syntax of the parameter depends on the 
current coordinate mode, as set by the most recent SET- 
COORDINATE-MODE command. 

Even though the viewport exists in raster memory space, 
the viewport corners are specified in "normalized screen 
coordinate space." In a 41 1 2 or 41 1 3, this normalized space 
is 4096-by-3072; the terminal converts coordinates to 
640-by-480 "raster memory space" by multiplying by 5 and 
dividing by 32. In the 41 15, the normalized coordinate 
space is 4096-by-3277; the terminal converts normalized 
coordinates by multiplying by 5 and dividing by 16. 



NOTE 

Changing the viewport changes the location on the 
screen where existing segments are displayed. How- 
ever, segments that are visible when the viewport 
change occurs do not automatically move to their 
new screen locations. To make the terminal redraw 
segments at their new screen locations, you should 
issue a RENE W- VIE WorPA GE command imme- 
diately after changing the viewport. 

If you don 't do this, and thefixup level is greater 
than or equal to 4, then moving a segment may not 
cause that segment's old image to be properly 
removed from the screen. Multiple images of the 
segment will appear. The remedy is to issue 
RENE W- VIE W or PAGE either immediately after 
the SET-VIEWPORT command or immediately 
after moving a segment. 



DEFAULTS 

first-corner 

as shipped — (0,0) 
on power-up — (0,0) 
if omitted — (0,0) 

second-corner 

as shipped — 4112,4113: (4095,3071) 

4115: (4095,3276) 
on power-up — 4112,411 3: (4095,3071 ) 

41 15: (4095,3276) 
if omitted — (0,0) 
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ERRORS 

RVOO (Level 0): Unrecognized command. (The terminal 
isnota4112,4113,or4115.) 

RV01 (Level 2): Invalid SET-VIEWPORT command. (The 
viewport must not be more than eight 
times larger than the current window; 
4112, 411 3 only.) 

RV1 1 (Level 2): InvaWd first-corner. (41 1 2, 41 1 3: X = to 
4095, Y = to 3071 ; 41 15: X = to4095, 
Y = to 3276.) 

RV21 (Level 2): Invalid second-corner. (41 1 2, 41 1 3: X = 
to4095,Y = 0to3071;4115:X = Oto 
4095, Y = Oto 3276.) 



REFERENCES 

DELETE-VIEW command 
SELECT-VIEW command 
SET-COORDI NATE-MODE command 
SET-VIEW-ATTRIBUTES command 
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SET-WINDOW Command 



4112,4113,4115 



Host Syntax 



E cRW xy.first-corner xy.second-corner 



Setup Syntax 




PARAMETERS 

first-corner (41 1 2, 41 1 3: X = to 4095, Y = to 4095; 
41 15: X = -2 31 to 2 31 -1 , Y = -2 31 to 2 31 -1). 
Specifies one corner of the window in terminal space for 
the current view. 

second-corner (41 1 2, 41 1 3: X = to 4095, Y = to 4095; 
41 15: X = -2 31 to 2 31 -1 , Y = -2 31 to 2 31 -1). 
Specifies the opposite corner of the window. 



DESCRIPTION 

This command sets the boundaries of the current view's 
window in terminal space. The window is the rectangular 
region in terminal space whose contents are displayed in 
a viewport on the screen. 

The parameters specify two opposite corners of the window. 
These may be any two opposite corners; the terminal sorts 
the two x-coordinates and the two y-coordinates in the 
proper order. 



Specifying a Window of Zero Width. If the rectangle speci- 
fied has zero width (that is, if the two x-coordinates are 
equal), then a width is chosen for the window such that the 
window (in terminal space) will have the same aspect ratio 
(ratio of height to width) as the corresponding viewport (in 



raster memory space). In that window, Xmin (the x-coordi- 
nate of the lower left corner) is the x-coordinate specified in 
the command. Xmax (the x-coordinate of the upper right 
corner) is automatically chosen so that the window is the 
same shape as the viewport. This can result in an Xmax 
greater than 4095 on a 41 1 2 or 41 1 3, or than 2 31 -1 on a 
41 1 5. If this occurs, error RW21 is detected and the window 
is unchanged. 



Specifying a Window of Zero Height. Likewise, if the two 
xy parameters specify a rectangle of zero height (that is, if 
the two y-coordinates are equal), then a height is chosen for 
the window such that the window (in terminal space) will 
have the same shape as the corresponding viewport (in 
raster memory space). In that window, Ymin is the y-coordi- 
nate specified in the command's two xy parameters. Ymax 
is chosen so that the window has the same shape as the 
viewport. This can result in an Ymax greater than 4095 on a 
41 1 2 or 411 3, or than 2 31 -1 on a 41 1 5. If this occurs, error 
RW21 is detected and the window is unchanged. 

Specifying the "Default" Window. If both width and height 
are zero (that is, if both "lower left" and "upper right" refer 
to the same point), then a window is selected which 
extends, on the 41 1 2 and 41 1 3, from X = to X = 4095, and 
from Y = to Y = 31 27. On a 41 1 5, this default window is the 
partial overview window as defined by the SET-OVERVIEW- 
WINDOW command. 
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NOTE 

Changing the window changes the location on the 
screen where existing segments are displayed. How- 
ever, segments that are visible when the window 
change occurs do not automatically move to their 
new screen locations. To make the terminal redraw 
segments at their new screen locations, you should 
issue a RENEW- VIEW or PA GE command imme- 
diately after changing the window. 

If you don 't do this, and thefixup level is greater 
than or equal to 4, then moving a segment may not 
cause that segment 's old image to be property 
removed from the screen. Multiple images of the 
segment will appear. The remedy is to issue 
RENEW- VIE W or PAGE either immediately after 
the SET- WINDOW command or immediately after 
moving a segment. 



Effect On Other Views in the Same View Display Cluster. 

Views may be grouped into "view display clusters." (See 
the SET-VIEW-DISPLAY-CLUSTER command for details.) 
if the current view beiongs to a view display cluster, and a 
SET-WINDOW command is issued, then that SET-WINDOW 
command sets the window not only for the current view, but 
also for all other views in that cluster. 



"Clipping" in the 4112,4113, and 41 1 5. The 41 1 2 and 

41 1 3 terminals perform a "window-viewport transform" on 
each visible segment. That is, for each segment defined 
in terminal space coordinates, the terminal computes an 
"image" of that segment in 640-by-480 raster memory 
space. The window coordinates (in terminal space) and the 
viewport coordinates (in raster memory space) together 
define this window-viewport transform. Those parts of the 
image in raster memory space which fall outside the current 
viewport are "clipped;" that is, those parts of the image are. 
not displayed. The 41 15 behaves like the other terminals 
with respect to "clipping," except that raster memory space 
measures 1280-by-1 024 (instead of 640-by-480). 

If the window (in terminal space) is numerically larger than 
the viewport, there will be a small range of coordinates 



which are nominally outside the window, but whose images 
are inside the viewport and are therefore displayed. Like- 
wise, if the window is very small (numerically smaller than 
the viewport), there will be a small range of coordinates 
which are nominally inside the window, but whose rniages 
are outside the viewport and are, therefore, not displayed. 



DEFAULTS 

first-corner 

as shipped — (0,0) 

Ul I [JUWCI -up — V u » u / 

if omitted — (0,0) 

second-corner 

as shipped — 4112,4113: (4095,31 27) 

41 15: depends on SET-OVERVIEW- 
WIN DOW 
on power-up — 4112,4113: (4095,31 27) 

41 15: depends on SET-OVERVIEW- 
WINDOW 
if omitted — (0,0) 

ERRORS 

RW00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113or4115.) 

RW01 (Level 2): One of the four coordinates is out of range 
(range is to 4095). 

RW11 (Level 2): lnvalid/Jraf-co/?7e/-(4112, 4113: X = Oto 
4095, Y = to 4095; 41 15: X = -2 31 to 
2 31 -1,Y = -2 31 to2 31 -1). 

RW21 (Level 2): Invalid second-corner (41 1 2, 41 1 3: X = 
to 4095, Y = to 4095; 41 1 5: X = -2 31 to 
2 31 -1,Y = -2 31 to2 31 -1). 



REFERENCES 

SET-VIEWPORT command 
SET-OVERVIEW-WINDOW command 
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SET-4014-ALPHATEXT-SIZE Command 



4114,4115,4116 



Host Syntax 




DESCRIPTION 



DEFAULT 



4114, 4116. This command is provided for compatibility 
with earlier TEKTRONIX terminals. The two-character 
parameters are equivalent to the certain integer settings of 
the SET-ALPHATEXT-SIZE command. 

The size of alphatext set by each two-character command 
depends on the alphatext group assigned by the SELECT- 
ALPHATEXT-SIZE-GROUP command. Table 7-25 summa- 
rizes how alphatext sizes change when different alphatext 
size groups are assigned. 



41 15. This command selects between the two character 
sizes available in 41 15 graphics and dialog areas: 

E c8 = 1 6 by 30 pixels, 80 characters per line 

and 34 lines (same size as 4113). 

E c9 = same as E c8. 

E c: = 8 by 16 pixels, 160 characters per line 

and 64 lines. 

E c: = same as E c:. 



4114,4116: 

as shipped — E c8 

on power-up — remembered 

if omitted — N/A 

4115: 

as shipped — E c8 
on power-up — E c8 
if omitted — N/A 



REFERENCES 

SELECT-ALPHATEXT-SIZE-GROUP command 
SET-ALPHATEXT-SIZE command 



Table 7-25 
41 14 AND 41 16 PRE-DEFINED TEXT SIZES 



SETALPHATEXT- 
SIZE-GROUP int 


SET-4014ALPHATEXT- 
SIZE setting 


SETALPHATEXT- 
SIZE ints 


Characters 
per Line 


Lines 
per Page 


0or1 


E c8 


10,6,28 


74 


35 


0or1 


E c9 


9, 6, 28 


81 


38 





E c: 


6,4,17 


121 


58 


1 


E c: 


5,6,18 


133 


64 





E c; 


5,6,18 


133 


64 


1 


E c; 


4,3,12 


179 


76 
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SET-4014-LINE-STYLE Command 



Host Syntax 




PARAMETERS 

line-style-code (' to o). 

An ASCII character with decimal equivalent in the range 
from 96 to 1 1 1 . 



DESCRIPTION 

The SET-401 4-LINE-STYLE command an alternate to the 
SET-LINE-STYLE and SET-LINE-WIDTH commands. It is 
compatible with the command used to set dash patterns on 
earlier TEKTRONIX terminals. The line-styles (all terminals) 
and line-widths (41 14 and 41 1 6 only) that are set by this 
command are: 



Markers and text are aiways displayed with soiid iines. i he 
default line style is that for the character ': a solid focused 
line. 

This command sets the dashed-line generator to the begin- 
ning of the new line-style. 

REFERENCES 

SET-LINE-STYLE command 
SET-LINE-WIDTH command 



SET-401 4-LINE-STYLE 


line 


-style 


line-width 


E C 










E ca 


1 







E cb 


2 







E cc 


3 









A 




Q 


E ce 


5 







E cf 


6 







c cg 


7 







E ch 









E ci 


1 
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SETUP Key 



DESCRIPTION 

Pressing the SETUP key puts the terminal in Setup mode 
and turns on the light on the key. Pressing the key again 
removes the terminal from Setup mode and extinguishes 
the light. 

Pressing SHIFT-SETUP has the same effect as pressing 
SETUP. 

The SETUP key does not auto-repeat. 



When the dialog area is not enabled, alphatext typed in 
Setup mode is displayed together with graphics, and 
updates the graphic beam position. When the dialog area is 
enabled, alphatext typed in Setup mode is displayed in the 
dialog area, and has no effect on the graphic beam position. 

REFERENCES 

Description of Setup mode in the Operator's Manual for the 
particular terminal. 



If you enter Setup mode while GIN is enabled, the graphic 
cursor disappears until you exit Setup mode. While the 
terminal is in Setup mode, the enabled GIN device is not 
used for input to the suspended GIN operation. 
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s i Character 



s o Character 



DESCRIPTION 

This character selects the JIS Roman font when the termi- 
nal has the Katakana keyboard (Option 4K) installed. The 
JIS Roman font remains in effect until an s o character is 
received. 

If the terminal is in eight-bit block mode, or is using DATA 

U'O.1 ILV (3IIU IL I CUCIVC3 GU^l IOICAL, Ll IO IUI ll 10 OCTSVICW k/jf u iS 

eighth bit, and not by the s i character. Characters with ASCII 
decimal equivalents (ADEs) from to 1 27 are displayed in 
JIS Roman font; characters with ADEs from 1 28 to 255 are 
displayes in JIS Katakana font. 



REFERENCES 

SET-PARITY command 
s o character 



DESCRIPTION 

This character selects the JIS Katakana font when the ter- 
minal has the keyboard (Option 4K) installed. The JIS Kata- 
kana font remains in effect until an s i character is received. 

If the terminal is in eight-bit block mode, or is using DATA 
parity and it receives alphatext, the font is selected by the 
eighth bit and not bv the ^o character. Characters with 
ASCII decimal equivalents (ADEs) from to 127 are dis- 
played in JIS Roman font; characters with ADEs from 1 28 to 
255 are displayed in JIS Katakana font. 



REFERENCES 

SET-PARITY command 
s i character 



41 10 SERIES COMMAND REFERENCE 



7-375 



TEK COMMANDS 



SPOOL Command 



Host Syntax 



E cJS tiev\ce:source sir'mg.separator dewice.destination 



Setup Syntax 




PARAMETERS 

source 

The source of data for the spool operation. Valid specifi- 
ers are: 

HO: the host computer 

FO:filename files on Disk Drive 
filename 

F1 :filename files on Disk Drive 1 

SO:filename— files on Option 45 devices 
Z7:filename 



PO: 
P1: 
P2: 

DM: 



Option 10; the Three Port 
Peripheral Interface 

The DMA interface (Option 3A) 



separator 

The empty string or the two-character string, TO. 



destination 

The destination for the spool operation. Valid specifiers 
are: 



HO: 



the host computer 



F0:filename files on Disk Drive 
filename 

F1 : filename files on Disk Drive 1 

SO:filename— files on Option 45 devices 
Z7:filename 



PO: 
P1: 
P2: 

HC: 



DM: 



Option 10; the Three Port 
Peripheral Interface 

Option 9; the Color Hardcopy 
Interface 

The DMA interface (Option 3A) 
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DESCRIPTION 

This command spools files from the device specified by the 
source parameter to the device specf ied by the destination 
parameter. This command is similar to the COPY command, 
except that once initiated, the operation proceeds in the 
background mode, allowing the terminal to be used for 
other operations. All terminal activity can proceed while a 
spool operation is currently in progress. 

The SPOOL command cannot be used to make a copy of 
the entire disk. That is, a specific disk file must be named 
in the input specifier: "FO: FILENAME" is allowed, but 
"F0:"isnot. 

If a SPOOL command is given while a spool operation is 
currently in progress, an error occurs, but the current spool- 
ing operation is not disturbed. 

A spooling operation cannot be aborted by pressing the 
CANCEL key on the keyboard. The STOP-SPOOLING 
command must be used. 



DEFAULTS 

source 

as shipped — none 
on power-up — none 
if omitted — error JS1 1 

separator 

as shipped — none 
on power-up — none 
if omitted — error JS21 

destination 

as shipped — none 
on power-up — none 
if omitted — error JS31 



ERRORS 

JS01 (Level 2): 
JS02 (Level 3): 



Data format error (Options 3A and 9 only). 



Out of memory while attempting DMA 
transfer (Option 3A only). 

JS03 (Level 2): Command context error. (A spooling 
operation is already in progress.) 

JS10 (Level 2): Specified source does not exist. 

JS1 1 (Level 2): invalid source specifier. 

JS1 2 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

JS13 (Level 2): Parameter 1 context error. (Not a valid 
source device, or device is busy.) 

JS1 9 (Level 2): Device hardware error (disk hardware 

error, drive not ready, or DMA block trans- 
fer error). 

■JS20 (Level 2): Separator parameter is missing. 

JS21 (Level 2): Invalid separator (must be empty string or 
TO. Setup mode must be TO). 

JS22 (Level 3): Out of memory while parsing parameter. 

JS30 (Level 2): Specified destination does not exist. 

JS31 (Level 1): Invalid destination device specifier. 

JS32 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

JS33 (Level 2): Parameter 3 context error. (Not a valid 

destination, device is busy, or existing file 
is write protected or open.) 

JS39 (Level 2): Device hardware error (disk hardware 

error, drive not ready, or DMA block trans- 
fer error). 



REFERENCES 

COPY command 
EOF-string syntactic construct 
EOM-indicator syntactic construct 
SET-EOF-STRING command 
SET-REPORT-MAX-LINE-LENGTH command 
SET-USER-NUMBER command 
STOP-SPOOLING command 
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Section 7 (cont) p a g e 

STATUS Command 7-379 

STOP-SPOOLING Command 7-38O 

String Parameter Type 7.381 

String-Report Message Type 7-382 

Terminal-Settings-Report Message Type 7-383 

u s Character 7-388 

VIEW Key 7.339 

v t Character 7-390 

XY Parameter Type 7-391 

XY-Report Message Type 7-394 

ZOOM Key 7-396 

4010-Gin-Report Syntactic Construct 7-397 

4010-HARDCOPY Command 7.399 

4010-Status-Report Message Type 7-400 

4953-Tablet-Gin-Report Syntactic Construct 7-402 
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STATUS Command 

There is no escape sequence for the STATUS command. DESCRIPTION 

This command can only be typed by the operator while the 

terminal is in Setup mode. This command causes the terminal to display the current 

values of many of its settings. For details, see the Opera- 
tor's Manual for the particular terminal. 
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STOP-SPOOLING Command 
Host Syntax 




Setup Syntax 



STOP 



DESCRIPTION REFERENCES 

This command aborts the spooling operation currently in SPOOL command 

progress. It also aborts any DMA transfers that may be in 
progress on a 41 1 5 terminal with Option 3A installed. The 
output file is closed. 
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String Parameter Type 

SYNTAX 



string = char-array 
int[char...\ 



DESCRIPTION REFERENCES 

A string is an array of chars; see the description of the array Array parameter type 

parameter type for details. Char parameter type 

Int parameter type 
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String-Report Message Type 

SYNTAX 



string-report = \nX-report:number-of-char-reports 
[char-report...] 

= char-array-report 



DESCRIPTION REFERENCES 

A string-report is a char-array-report; see the array-report Array-report parameter type 

description for details. Char-report parameter type 

Int-report parameter type 
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Terminal-Settings-Report Message Type 



SYNTAX 



terminal-settings-report = 



[EOM-indicator] 
[sig-char] 
op-code- report 
[parameter-report. . 
EOM-indicator 



op-code-report = char-report char-report 



int-report 
real-report 
char-report 
xy-report 
int-array-report \ 



parameter-report = - 



DESCRIPTION 

The terminal-settings-report report is sent to the host com- 
puter in response to a REPORT-TERMINAL-SETTINGS 
command. 

When the terminal sends a report to the host, Bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 



However, if the REPORT-TERMINAL-SETTINGS command 
specified an op code for a command which does not exist, 
or which is not installed in theteminal, then the op-code- 
report is s p s p. 

The special inquiry codes are listed in Table 7-26. For each 
inquiry code, the table also shows the parameter-reports 
which are included in that inquiry code's terminal-settings- 
report. 



Optional EOM-indicator. An optional EOM-indicator is pro- 
vided at the start of the terminal-settings-report because of 
the terminal's "maximum line length" feature. (See the 
description of the SET-REPORT-MAX-LINE-LENGTH com- 
mand for details.) This EOM-indicator is only sent if not 
sending it would cause the terminal's maximum line length 
to be exceeded. 



Signature Character. The sig-char (signature character) is 
sent only if it is not < NL> . This character is the current sig- 
char tor non-GIN reports, as set by the most recent SET- 
REPORT-SIG-CHARS command. 



Op-Code-Report. Next comes the op-code-report, consist- 
ing of two char-reports. The two chars being reported are 
the same two characters which were used in the REPORT- 
TERMINAL-SETTINGS command; they comprise either an 
op code for one of the terminal's commands, or else a spe- 
cial inquiry code. 



Code 



?M 



?T 



00 



Table 7-26 
SPECIAL INQUIRY CODES 



01 to 98 



Associated Parameter-Reports 



int-report : available-memory int-report : 
largest-contiguous-block (The available memory, and the 
size of the largest contiguous block, are reported as a 
number of 1 6-byte units of memory.) 



int-report: model-number-code (For the 41 12, the model 
number code is 41 1 2; for the 41 1 4, the code is 41 1 4, etc.) 



i nt-report: standard-f i rmware-version-n umber 



99 



int-report: optional-firmware-version-number (If a 
firmware option is not installed, the version number 
reported is zero.) Option 20 (in a 41 1 2) and Option 21 (in a 
41 13) are hardware options, the terminal returns "1 " if 
the option is installed, or "0" if the option is not installed. 



int-report: low-part-number The low part number on the 
FE ROM. For internal use by service personel. 
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Parameter-Report The command specified by op code in 
the op-code-report has in its syntax a number of parame- 
ters. The current values of these parameters are returned, 
in order, in the parameter-reports. 

Each parameter-report is of an appropriate type for the 
parameter being reported. For instance, consider a termi- 
nal-settings-report tor \he terminal's baud rate. The SET- 
BAUD-RATE command (op code NR) has two parameters of 
type int. The terminal sends the values of int parameters to 
the host using the int-report syntax. Therefore, in the cor- 
responding terminal-settings-report, there are two parame- 
ter-reports, each being an int-report. 

For the special inquiry codes, the parameter-report are 
those listed earlier, in Table 7-26. 



Examples 



Reporting the Amount of Available Memory. To request a 
report on the amount available memory, the host sends a 
REPORT-TERMINAL-SETTINGS: ?M command. If the sig- 
char and EOL-string are as in the previous example, and 
that the terminal is not in block mode, then the report which 
the terminal sends the host is as follows: 

terminal-settings-report 

[EOM-character] (usually omitted) 

sig-char 

op-code-report 

paxameXer-repoxtavailable-memory 

parameter-reportlargest-block 

EOM-indicator 

= A 
?M 

int-report:ava/toWe-memoo' 
int-reportlargest-block 



Reporting the baud rates. The REPORT-TERMINAL-SET- 
TINGS : NR command requests the terminal to send a 
report of its current baud rate settings. (This is because it is 
the SET-BAUD-RATES command which has the op code 
NR.) 

Assume that the terminal is not in block mode, that its cur- 
rent EOL-string is the single character, c r, and that the sig- 
chariox non-GIN reports is (A). Assume also that the 
terminal is set to transmit and receive at 1200 baud. In that 
case, the report which the terminal sends to the host is: 

terminal-settings-report 

[EOM-character] (usually omitted) 

sig-char 

op-code-report 

parameler-repor\:first-baud-rate 

parameler-repor\:second-baud-rate 

EOM-indicator 

= A 
NR 

int-report: 1200 
int-report: 1200 

C R 

= ANR! + 0! + c r 



Exceptions 

For a few commands (op codes) the meanings of the param- 
eters reported in the terminal-settings-report differ from the 
meanings of the parameters when sending those com- 
mands to the terminal. These commands are: 

PROMPT-MODE (op code NM) 
LOCK-VIEWING-KEYS (op code RJ) 
SET-SURFACE-GRAY-LEVELS (op code RG) 
SET-SURFACE-COLOR-MAP (op code TG) 



PROMPT-MODE. Prompt mode can be turned on with a 
parameter of 1 or 2. However, the terminal only reports 
whether the Prompt mode is on (1 ) or off (0). 



LOCK-VIEWING-KEYS. The LOCK-VIEWING-KEYS com- 
mand exists in the 41 1 2, 41 1 3, and 4115 terminals, but not 
in the 41 14 or 41 16 terminal. This command takes the form 
^RJ int. Therefore, a REPORT-TERMINAL-SETTINGS: RJ 
command causes the terminal to send a terminal-settings- 
report which has one parameter-report, of the int-report 
type: 



terminal-settings-report = 



[EOM-indicator] 

[sig-char] 

RJ 

int-report wiewing-key-status 

EOM-indicator . 
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In this report, however, the "viewing key status" integer can 
assume more values than just zero and one. It can assume 
values from zero to three. The meanings of these are as 
follows: 

The terminal is in not in framing mode. (That 
is, it is neither in ZOOM mode nor in PAN 
mode.) Moreover, the viewing keys are not 
locked. (This does not preclude the entire 
keyboard's being locked as a result of a lock- 
keyboard command.) 

1 The terminal is in ZOOM mode. 

2 The terminal is in PAN mode. 

3 The viewing keys are locked. (Therefore, the 
terminal is neither in ZOOM mode nor in PAN 
mode.) 



SET-SURFACE-GRAY-LEVELS Command. The SET-SUR- 
FACE-GRAY-LEVELS exists in the 41 1 2, 4i 1 3, and 41 1 5 ter- 
minals, but not in the 41 14 or 41 16. This command has the 
syntax E cRG int int-array. Therefore, a REPORT-TERMI- 
NAL-SETTINGS: RG causes the terminal to send a termi- 
nal-settings-report message, which has two 
parameter-reports, of the int-report and int-array-report 
types. However, the meanings of these parameter-reports 
differ from those of the corresponding parameters in the 
SET-SURFACE-GRAY-LEVELS command: 

terminal-settings-report 
[EOM-indicator] 
[sig-char] 
RG 

\n\-reporknumber-of-surfaces 
M-anay-reporX:gray-levels-for-surfaces 
EOM-indicator . 

In this terminal-settings-report, the int-report te\\s how many 
surfaces are defined. 

The int-array-report contains surface numbers (expressed 
as negative integers), followed by the gray-levels for each 
surface (expressed as positive integers). Consider, for 
instance, the following int-array-report: 

int-array-report: (-1 , 90, -2, 30, 60, 90) 

This is interpreted as meaning that surface one has color 
index one set to 90% lightness, while surface two has color 
index one set to 30%, color index two set to 60%, and color 
index three set to 90%. (Since color index zero always 
means "transparent," no gray-level is reported for color 
index zero. 



The number of gray-levels reported for each surface is one 
less than two to the power N. where N is the number of bit 
planes assigned to that surface. Thus, a surface with one bit 
plane has one gray-level reported, while a surface with two 
bit planes has three gray-levels reported. If a surface has 
zero bit planes, then no gray-levels are reported for it. Con- 
sider, for instance, the following int-array-report: 

int-array-report: (-1 ,-2,10,15,30,45,55,70,90) 

This wouid be interpreted to mean that surface one has no 
bit planes (and therefore no gray-levels to report), while sur- 
face two has three bit planes. The gray-level for the color 
index one on surface two is 10%, that for color index two on 
surface two is 15%, and so on. 

SET-SURFACE-COLOR-MAP Command. The SET-SUR- 
FACE-COLOR-MAP command exists in the 41 12, 41 13, and 

4i A ^ tormiriQl hi it r\r\\ \r\ \)nc± A~\ "i A r\r A A ^ R "Tkiie- r*r\rr\nr\&r*tr\ 
i ■ v> tvsi iiiinui, k/uk i t\s< ■■ ■ u i\j ~t ■ i-rt^i -r i t \s. i mo u^iiiiiiui ivj 

has the syntax E cTG int-array. Therefore, a REPORT-TER- 
MINAL-SETTINGS: TG command causes the terminal to 
send to the host a terminal-settings-report with the following 
syntax: 

term inal-settings-report 
[EOM-indicator] 
[sig-char] 
TG 

\nt-reportnumber-of-surfaces 
\nt-anay-repor\:color-info 
EOM-indicator 

Here, the int-array tells the number of surfaces currently 
defined, while the int-array-report contains information 
about the background color mixture, and about the color 
mixtures for each of the color indices on each of the sur- 
faces. (This is different from the meaning these parameters 
have when they are in SET-SURFACE-COLOR-MAP com- 
mand sent from the host to the terminal. 

int-array-report:co/or-/«/b 

\r\X-repoft:number-of-int-reports-to-follow 
tr\p\e-report:background-color 
[colors-for-one-surface. ..] 

colors-for-one-surface 

M-reporl:negative-surface-number 
[\np\e:color-coordinates-for-one-color-index. ..] 



triple-report 



IHLS-triple-report ] 
RGB-triple-report \ 
CMY-triple-report J 
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HLS-triple-report 



RGB-triple-report 



CMY-triple-report = 



\nX-xepoxX:hue-angle-in-degrees 
i nt-report : lightness-percentage 
\nX-teporX:saturation-percentage 

\nX-reporX:red-percentage 

\nX-reporX:green-percentage 

\nX-reportblue-percentage 

\nt-reporX:cyan-percentage 

\nX-reporX:magenta-percentage 

\r\X-teporX.blue-percentage 



Likewise, the next ten int-reports carry the numbers -2, 
180, 50, 100, 240, 50, 100, 0, 100, 0. These give three sets 
of color coordinates for surface number two. On that sur- 
face, color index one is displayed as yellow (hue 180, light- 
ness 50, saturation 100), color index two as green (hue 240, 
lightness 50, saturation 100), and color index three as white 
(hue 0, lightness 100, saturation 0). Since three sets of color 
coordinates are reported for surface two, that surface must 
have two bit planes assigned to it. 



The HLS, RGB, or CMY color coordinate system is used in 
the report, depending on which color specifying mode was 
selected by the most recent SET-COLOR-MODE command. 

Suppose, for instance, that HLS color coordinates are being 
used. (This is the default when the terminal is turned on.) 
Consider the following int-array-report: 



int-array-report:co/or-/n/o 



int-report: 17 
int-report: 
int-report: 
int-report: 
int-report: -1 
int-report: 120 
int-report: 50 
int-report: 100 
int-report: -2 
int-report: 180 
int-report: 50 
int-report: 100 
int-report: 240 
int-report: 50 
int-report: 100 
int-report: 
int-report: 100 
int-report: 



Here, the first int-report says that there are 1 7 int-reports to 
follow in the int-array-report. 

The next three int-reports say that the background color is 
black (hue zero degrees, lightness zero, saturation zero). 

The following four int-reports carry the numbers -1 , 1 20, 
50, 100. Thus, on surface one, color index one is displayed 
as a red color (hue 1 20 degrees, lightness 50, saturation 
100). Since only one set of three coordinates follows the -1 , 
there must be only one non-zero color index for that sur- 
face. In other words, surface one has only one bit plane 
assigned to it. 



SET-VIEW-DISPLAY-CLUSTER Command. The command 
exists in the 41 1 2, 41 1 3, and 41 1 5 terminals only. 

This command has the syntax E cRQ int-array. Therefore, 
the command, 

REPORT-TERMINAL-SETTINGS : RQ 

= E clQRQ 

causes the terminal to send to the host a terminal-settings- 
report with the following syntax: 

terminal-settings-report = [EOM-indicator] 

[sig-char] 

RQ int-array-report 
EOM-indicator 

Here, the int-array-report tells how views are grouped into 
view display clusters. For the purposes of this report, the 
clusters are assigned numbers. The first number in the int- 
array-report tells to which cluster, if any, view number one is 
assigned. Likewise, the second number in the array tells to 
which cluster view two is assigned, — and so on. If a view 
has not been assigned to any display cluster, then "cluster 
number zero" is reported for that view. 

Suppose, for instance, that the signature character for non- 
GIN reports is the tilde (~), and that the host has issued the 
character sequence, E clQRQ. (This is a REPORT-TERMI- 
NAL-SETTINGS command which inquires about the view 
display cluster settings.) One possible response from the 
terminal would be: 

" RQ s p s p6 s p s p1 s p s p1 s p s p1 s p s pO s p s p2 s p s p2 c r 
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Here, the tilde (") is the sig-char, the characters RQ signify 
that the report is for the RQ op code, and the final c r is the 
EOM-indicator. The other characters comprise an int- 
array-report, as follows: 



s p s p6 = 

SpSpl = 

s p s p1 = 

s p s p1 = 

SpSpQ = 

s p s p2 = 

s p s p2 = 



int-report: 6 The array has six items. 

int-report: 1 View 1 is in display cluster 1 . 

int-report: 1 View 2 is in display cluster 1 . 

int-report: 1 View 3 is in display cluster 1 . 

int-report: View 4 is not in any display 
cluster. 

int-report: 2 View 5 is in display cluster 2. 

int-report: 2 View 6 is in display cluster 2. 



Thus, the terminal-settings-report tells the host these 
things: 

• The highest-numbered view which is in a view display 
cluster is view number six. 

• Views one, two, and three are in the same display 
cluster. 

• Views five and six are in the same display cluster. 

• View four is not in any view display cluster. 



REFERENCES 

Array-report parameter type 
Char-report parameter type 
Int-report parameter type 
Real-report parameter type 
REPORT-TERMINAL-SETTINGS command 
SET-SURFACE-COLOR-MAP command 
SET-SURFACE-GRAY-LEVELS command 
SET-VIEW-DISPLAY-CLUSTER command 
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u s Character 

See the description of the enter-alpha-mode command. 
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VIEW Key 



4112,4113,4115 



The VIEW key exists only in the 41 12, 41 13, and 41 15 termi- 
nals. It does not auto-repeat. 

Pressing the VIEW key causes the current viewport to be 
wiped, the window for the current view to be defined accord- 
ing to the current framing box for that view, and the view to 
be redrawn using the new window-viewport transform. (The 
"framing box" is a "proposed new window" which the oper- 
ator defines using the PAN and ZOOM keys. This "pro- 
posed new window" takes effect when the operator presses 
the VIEW key.) 

When the operator presses the VIEW key, the old value of 
the framing box becomes the new values for both the win- 
dow and the framing box. The terminal remembers the old 
window and oid framing box by storing them in a memory 
stack, whose stack depth never exceeds three. (These old 
vaiues may be recovered by pressing the RESTOR key.) 



CTRL-VIEW. Pressing CTRL-VIEW (pressing the VIEW key 
while holding down the CTRL key) causes the following to 
occur: 

1 . The next higher-numbered view is selected. 

2. The VIEW function is performed on that view. 

3. The original view is selected again. 

In other words, pressing CTRL-VIEW is equivalent to press- 

mg ihe lonuwing Keys. inovi vicvV, ViciTv, \j i riu-iNt/v i- 

VIEW. 



If the same segments are visible in both views, the CTRL- 
VIEW feature makes it easy to use one viewport to show an 
enlargement of part of the picture shown in the other 
viewport. 

The 41 1 5 retains the last three views and the overview. 
Repeated pressing of the RESTORE key cycles through the 
four retained views. 



Effect On Other Views in the Same View Display Cluster. 

In the 41 1 2, 41 1 3, and 41 1 5 terminals, views may be 
grouped into "view display clusters." (See the SET-VIEW- 
DISPLAY-CLUSTER command for details.) If the current 
view belongs to a view display cluster, and the VIEW (or 

^TDI \/ir\/W\ 1^-,, it- nr/M.OA^< (kgnlksWmU'nrrTDI, 
\j i I ii_- v it_v v f r\cy to pi cdocu, n ici i u ic v ii— ■ v \\jt w i ■ it- 

VIEW) key affects not only the current view, but also all 
other views in that cluster. That is, all views in the cluster 
have their windows updated to match the current framing 
box, and all views in the cluster have their viewports erased 
and redrawn. 



REFERENCES 

PAN key 
RESTORE key 
ZOOM key 
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v t Character 

DESCRIPTION REFERENCES 

Alpha Mode; Dialog Area Disabled. When the terminal is in ENTER-ALPHA-MODE command 

Alpha mode with the dialog area disabled, the ASCII v t ENTER-VECTOR-MODE command 

character ("vertical tab" character) causes the alpha cursor ENTER-MARKER-MODE command 
to move up one line. If already at the top, no action occurs. 



Alpha Mode; Dialog Area Enabled. If the dialog area is 
enabled, no action occurs. 



vector and marker modes, wnen tne terminal is in vector 
mode or marker mode, the v t character has no effect. 
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XY Parameter Type 



SYNTAX 



xy = 



1 12-bit-xy 
1 32-bit-xy 



1 



12-bit-xy = [HiY] [ [Extra] LoY [HiX] ] LoX 

32-bit-xy = \ntx-coord int \y-coord (41 15 Coordinate model only) 

/!// = an aooii criatauier Witii inyii-umci uiio kh — owioiowoniiino ,n,,„ u „ uu .,<.w,,.,» — ~~— _. — 

ASCII chart. 
Extra = an ASCII character with high-order bits "1 1 " — a character in the "lowercase" column of the ASCII chart. 
LoY = an ASCII character with high-order bits "1 1 " — a characte in the "lowercase" column of the ASCII chart. 

HiX = an ASCII character with high-order bits "01 " — a character in the "numbers and symbols" column of the 

ASCII chart. 
LoX = an ASCI! character with high-order bits "10" — a character in the "uppercase" column of the ASCII chart. 
x-coord = the x-coordinate sent as an int parameter (41 1 5 Coordinate mode 1 only). 
y-coord = the y-coordinate sent as an int parameter (41 1 5 Coordinate mode 1 only). 



Syntax Graph 

The syntax of 12-bit-xy is repeated in Figure 7-24 as a 
syntax graph. 



DESCRIPTION 

To send a pair of x- and y-coordinates to the terminal, you 
must encode them in a certain way. In this manual, the term 
xy refers to a pair of x- and y-coordinates as encoded for 
transmission to the terminal. The term xy: (100,200) refers 
to the coordinate pair (1 00,200), as encoded for trans- 
mission to the terminal. 



There are two ways to send xy parameters to a 41 1 5 termi- 
nal: with coordinate bytes, the same as for other 41 1 
Series terminals, or as a pair of int parameters. Details of 
sending xy parameters to a 41 1 5 terminal are discussed 
later in this description. 

Format of 12-Bit-XY Coordinate Bytes 
(All Terminals) 

Each xy parameter consists of from one to five ASCII 
characters (seven-bit bytes). The bytes are sent in this 
order: HiY Extra LoY HiX LoX. Figure 7-25 shows the 
formats of the five bytes. 




Figure 7-24. 12-Bit-XY Parameter Syntax. 
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Order and Meaning of the XY Characters 

1 . The ///T (high-order y) character comes first. This 
character contains the most-significant five bits of the 
binary numeral representing the y-coordinate. The 
seven bit ASCII character (excluding the eighth, or 
parity bit) has this format: 

1 y y y y y 

yyyyy : high-order five bits of the y-coordinate. 

You can omit the HiY byte if the high-order five bits of 
the y-coordinate have not changed since the last xy 
coordinate sent to the terminal. 

2. Next comes the Extra character. This character con- 
tains the margin bit, the least-significant two bits of the 
x-coordinate, and the least-significant two bits of the 
y-coordinate. 

1 1 m y y x x 

m : margin bit 

yy : least-significant bits of y-coordinate 

xx : least-significant bits of x-coordinate 

You can omit the Extra character if the least-significant 
bits of the x- and y-coordinates have not changed since 
the last xy coordinate sent to the terminal. If you do 
send the Extra character, you must follow it with the 
Lo Y character. Whenever an Extra byte with its margin 
bit set to zero is received by a 41 1 4 or 41 1 6, the current 
margin is reset to margin one (X = 0). 

3. Next comes the Lo Y (low-order y) character. Despite its 
name, this character contains the intermediate five bits 
of the 1 2-bit y-coordinate. 

1 1 y y y y y 

yyyyy : intermediate five bits of y-coordinate. 

You can omit the LoY character provided: (a) you are 
sending neither the Extra character nor the ///^char- 
acter in this xy coordinate, and (b) the intermediate five 
bits of the y-coordinate have not changed since the last 
xy coordinate sent to the terminal. 



4. Next comes the //^(high-order x) character. This 
character contains the high-order (most-significant) five 
bits of the x-coordinate. 

1 x x x x x 

xxxxx : most-significant five bits of x-coordinate. 

You can omit the ///.^character if the x-coordinate's 
most-significant bits have not changed since the last xy 
parameter sent to the terminal. If you do send the HiX 
character, then you must precede it with the LoY byte. 

5. Finally comes the LoX (low-order x) character. Again, 
despite its name, this character contains the interme- 
diate five bits of the x-coordinate. This character is 
always required, because it serves to terminate the xy 
parameter sequence. 



NOTE 

The LoY and Extra bytes each have high-order bits 
of 11. Thus the d t character (binary 1111111) is a 
possible LoY or Extra byte. Since some host com- 
puters use d t as a filler character, this could be a 
problem in some installations. 

The 4110 terminals include two features which 
together provide a way to overcome this difficulty. 
First, the terminal treats E c? as a synonym for the 
d t character. Secondly, it can be set to ignore d t 
characters. (Use the ignore-deletes command.) 

If your host computer uses d t as a filler character, 
then you should use these features. Have the host 
send E c? in place of D r in xy parameters, and send 
an ignore-deletes command to the terminal. 



32-Bit XY Coordinates (41 1 5 only) 

In the 4115, there are two ways of encoding xy coordinates. 
The most recent SET-COORDINATE-MODE command 
determines which way is used. 
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Coordinate Mode 0. In coordinate mode (the default, 
which is compatible with existing Tektronix terminals), the 
terminal uses the 12-bit-xy format. 

See the preceding description for details on the 12-bit-xy 
format. 



Coordinate Mode 1 . In coordinate mode 1 , the terminal 
expects 32-bit-xy coordinates: 

xy = int:x-coo«/int:.y-coo/-G? 

See the description of the int parameter for details on 
packing and sending ints. 



REFERENCES 

IGNORE-DELETES command 
Int parameter type 
SET-COORDINATE-MODE command 
SET-MARGINS command 
XY-report parameter type 



x-coordinate 
= binary 00C 


= dec 

oop_n 


mal J 
01^0 


52 




<xy 


(52,1000)> 


y-coordinate = decimal 1000 
= binary 001_nV1010 00_ 
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Figure 7-25. Format of 12-Bh-XY Bytes. 
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XY-Report Parameter Type 



SYNTAX 



xy-report = 


i 1 2-bit-xy-report 1 
\ 32-bit-xy-report i 


1 2-bit-xy-report 


= [EOM-indicator] 
char.HiY-report 
char.Extra-report 
char.LoY-report 
ch ar.HiX-report 
char.LoX-report 


32-bit-xy-report 


intc-report:x-coore? intc-report:j-coorrf (41 15 Coordinate mode 1 only) 



PARTS OF THE REPORT 

EOM-indicator. 

The EOM-indicator is rarely included in the xy-report. 
The terminal only sends this EOM-indicator if there is no 
other way to avoid exceeding the current maximum 
report line length. 

HiY-report, Extra-report, LoY-report, HiX-report and LoX- 

report. 

These are all ASCII characters with high-order bits "01 " 
— characters in the "numbers and symbols" column of 
the ASCII chart. They correspond to the bytes within an 
xy parameter sent to the terminal, but occupy different 
columns of the ASCII chart. 

x-coord and y-coord. 

A 32-bit-xy-report sent by the terminal as a pair of 
intc-report messages (41 15 Coordinate mode 1 only). 



The 41 15 terminal's xy-reports also resemble, but are 
slightly different than, the 41 1 5's xy parameters. Details on 
the xy-reports sent by 41 1 5 terminals are discussed later in 
this description. 

12-Bit-XY-Reports (All Terminals) 

The differences between xy parameters and xy-report 
messages are: 

• Under certain circumstances an EOM-indicator may 
precede the data bytes. 

• All five data bytes are always sent. 

• All five data bytes have the most-significant two bits 

of their seven data bits set to "01 ." (However, their sig- 
nificant five bits have identical meanings to the least- 
significant five bits in the corresponding characters of 
the xy parameter type.) 



DESCRIPTION 

When the terminal reports an xy-coordinate to the host 
computer, it sends that information using the xy-report 
syntax. The xy-reports (which the terminal sends to the 
host) resemble, but differ slightly from, the xy parameters 
(which the host sends to the terminal). 



EOM-indicator. The optional EOM-indicator, if sent in the 
xy-report, will always be the terminal's current EOL-string. 
This EOM-indicator is rarely sent. The reason for this is that 
an xy-report is always part of some larger report message, 
and the syntax of that larger report generally makes provi- 
sion (with its own EOM-indicators) for terminating lines 
before the maximum line length is exceeded. 
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However, if the maximum report line length is set too short, 
then it is possible that the optional EOM-indicators in the 
syntax of the larger report would not cause the line to termi- 
nate soon enough. Only in that case would the optional 
EOM-indicator in the xy-report syntax come into play. 

The optional EOM-indicator is included in an xy-report 
when all the following conditions are met: 

• The terminal is not in block mode. 

• At least one character has already been sent on the 
current line (that is, since the last EOM-char or EOM- 
indicator). 

• If the EOM-indicator were not to be sent, sending the 
five data bytes would cause the current maximum report 
line length to be exceeded. 



Parsing an XY-Report. A general-purpose routine for 
parsing xy-reports should take into account the optional 
EOM-indicator. 

Since this EOM-indicator is only sent if the terminal is not in 
block mode, and since in that case the EOM-indicator is 
just the current EOL-string, the parsing routine should be 
able to distinguish the current EOL-string from valid HiY- 
report, Extra-report, LoY-report, HiX-report, and LoX- 
report data bytes. 

The best way to do this is to choose an EOL-string which 
consists only of control characters, such as c r and l f. In that 
case, the parsing routine can just skip over any such control 
characters. For examples of this principle, see int-report 
and char-reoort messaae tvDe descriDtions. 



32-Bit-XY-Reports 

(41 1 5 Coordinate mode 1 only) 

41 1 5 terminals encode xy-report coordinates two ways. 
The most recent SET-COORDINATE-MODE command 
determines which method the terminal uses. 



Coordinate Mode 0. If the coordinate-mode parameter of 
the SET-COORDINATE-MODE command is (the default, 
which is compatible with existing Tektronix terminals), the 
terminal sends 12-bit-xy-reports. 

See the preceding description for details on 12-bit-xy- 
reports. 



Coordinate Mode One. If the coordinate-mode parameter 
is 1 , the terminal sends xy-reports as pairs of intc-report 
parameters: 

xy-report = intc-report:x-coorc? intc-report^-coorcf 
See the description of the intc-report parameter for details. 

REFERENCES 

Char-report parameter type 
EOM-indicator syntactic construct 
Intc-report parameter type 
SET-MAX-REPORT-LINE-LENGTH command 
XY parameter type 



41 10 SERIES COMMAND REFERENCE 



7-395 



TEK COMMANDS 



ZOOM Key 



4112,4113,4115 



DESCRIPTION 

The ZOOM key exists only in the 41 1 2, 41 1 3, and 41 1 5 
terminals. It does not auto-repeat. 



Entering ZOOM Mode. Pressing the ZOOM key while the 
light in the key is off puts the terminal in "framing mode," 
in the "ZOOM submode," and turns on the light in the 
key. A "framing box" appears on the screen, showing the 
boundaries of a "proposed new window." 



(To "zoom in" further than that, the operator must first press 
the VIEW key, updating the window. The operator can then 
continue to "zoom in", down to one-sixteenth the size of 
that window.) 

The operator cannot, by moving the thumbwheels in ZOOM 
mode, make the the framing box less than eight units wide 
or eight units high in terminal space. Nor is it desirable 
to zoom in to create that small a window. (At such small 
window sizes, the "granularity" of terminal space causes 
lines not to be displayed accurately.) 



The Framing Box. The framing box is a rectangle with a 
device in the center to indicate size and submode. This 
device consists of two corners of a rectangle which is one 
half as large as the framing box, and is centered on the 
center of the framing box. 



Changing the Size of the Framing Box. While the light in 
the ZOOM key is on, moving the thumbwheels causes the 
size of the framing box to change. The framing box is only 
a proposed new window; that window does not take effect 
until the operator presses the VIEW key. 

Moving either thumbwheel causes the box to grow or shrink 
evenly in both axes. Pressing SHIFT while moving the 
thumbwheels causes the box to grow or shrink more slowly; 
this is convenient for fine adjustment of the framing box 
size. 

Pressing the CTRL key while moving either thumbwheel 
causes the framing box to grow in only one direction 
(horizontal or vertical). This changes the aspect ratio of 
the window. 



Changing the Shape of the Framing Box. Pressing CTRL 
while moving a thumbwheel causes only one dimension of 
the framing box to change. (For instance, pressing CTRL 
and moving the vertical thumbwheel changes the height of 
the framing box, but does not change the width.) This lets 
the operator change the shape of the frame. (The operator 
can restore the "normal shape" — the same ratio of width to 
height as for the current view's viewport — by pressing the 
NORMAL key.) 



Minimum Size of Framing Box. The operator cannot, by 
moving the thumbwheels in ZOOM mode, make the framing 
box less than one sixteenth the size of the current window. 



Exiting ZOOM Mode. The operator can remove the terminal 
from ZOOM mode in two ways: 

• Pressing the PAN key leaves the terminal in "framing 
mode," but transfers it from the ZOOM submode to the 
PAN submode. The light in the ZOOM key goes out, 
while the light in the PAN key turns on. The device in the 
center of the framing box changes to a cross. 

• Pressing the ZOOM key removes the terminal both from 
framing mode and from the ZOOM submode. The light in 
the ZOOM key turns off. 



CTRL-ZOOM Key. If the terminal is in either "zoom" or 
"pan" mode (that is, if either the ZOOM or PAN light is on), 
then pressing CTRL-ZOOM produces a fixed zoom of the 
viewport. That is, pressing the ZOOM key while holding 
down the CTRL key is equivalent to entering "zoom" mode 
(if not already in that mode), moving the thumbwheels 
to make the framing box smaller, and then pressing the 
VIEW key. 

Views may be grouped into "view display clusters." (See 
the SET-VIEW-DISPLAY-CLUSTER command for details.) 
If the current view belongs to a view display cluster, then 
pressing CTRL-ZOOM affects not only the current view, but 
also all other views in that display cluster. 

REFERENCES 

NORMAL key 
PAN key 
VIEW key 
OVERVIEW key 
SET-WINDOW command 
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401 0-Gin-Report Syntactic Construct 



SYNTAX 



4010-GIN-report 


char, key-pressed 




4010-xy-report 




EOM-indicator 


4010-xy-report 


= HiX-report 




LoX-report 




HiY-report 




LoY-report 



PARTS OF THE REPORT 

key-pressed. 

A single ASCII character, corresponding to the key which 
the operator pressed to initiate the 4010-GIN-report. 

4010-xy-report. 

Tells the location of the GIN cursor when the operator 
pressed a key to initiate the GIN report. The position is 
reported in the format used by 401 0-series TEKTRONIX 
terminals; consequently, the position is reported only to 
a precision often (rather than 12) binary bits. 

HiX-report, LoX-report, HiY-report, LoY-report. 

These are all seven-bit ASCII characters with high-order 
bits "01 " — characters in the "figures" column of the 
ASCII chart. 



DESCRIPTION 

When the 41 10 responds to an ENABLE-4010-GIN com- 
mand — the sequence of characters e c s b — it is emulating a 
TEKTRONIX 4010 Series computer display terminal. There- 
fore, it sends coordinate information to the host computer 
using the 4010-GIN-report syntax rather than the GIN- 
report-sequence syntax that it uses when responding to the 
ENABLE-GIN command. 



When the terminal sends a report to the host, Bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 



Char Parameter. The first part of the 4010-GIN-report is a 
single ASCII character. This is the character for the key 
which the operator pressed to initiate the GIN report. (After 
the ENABLE-4010-GIN command, the terminal displays the 
graphics cursor. The operator positions the graphics cursor 
using the thumbwheels, and then presses a keyboard key 
to initiate the 4010-GIN-report. The char parameter in the 
4010-GIN-report is the ASCII character corresponding to 
the key which the operator pressed.) 



4010-Xy-Report Parameter. The second part of the 4010- 
GIN-report is the 4010-xy-report. This consists of four 
ASCII characters, corresponding to the HiX, LoX, HiY, 
and LoY characters in the xy parameters which the host 
may send to the terminal when displaying graphics on the 
terminal's screen. However, these characters differ from 
those in the xy syntax, in that their high-order bits ("tag 
bits") are always "01 ," placing them all in the "numbers 
and symbols" column of the ASCII chart. 

Also, the characters in the 401 0-xy-report are sent in the 
order HiX LoX HiY LoY. This is different from the order 
used in xy parameters. It is also different from the order 
used in xy-reports sent as part of GIN-report-sequences in 
response to the ENABLE-GIN command. 
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EOM-indicator. The £ , OM-«'nc?/ca?o/'("encl-of-message" 
indicator) marks the end of the report. If the terminal is not 
in block mode, this is just the current EOL-string, as set by 
the most recent SET-EOL-STRING command. Typically, this 
is just the "carriage return" character, c r. For more details, 
see the description of the EOM-indicator syntactic con- 
struct and the SET-EOL-STRING command. 

To most closely emulate the 4010 Series terminals, the 
terminal should not be in block mode. The EOL-string 
should be set (by a SET-EOL-STRING command, as in 
Table 7-27. 



Table 7-27 

EOL-STRING SETTINGS 
TO EMULATE 4010 SERIES TERMINALS 



GIN Strap 

(in 4010 Terminal) 


EOL-string 

(in 41 10 Terminal) 


CR and EOT 


C R E T 


CRonly 


C R 


no CR, no EOT 


empty string 



REFERENCES 

ENABLE-4010-GIN command 
EOM-indicator syntactic construct 
SET-REPORT-EOM-FREQUENCY command 
SET-EOL-STRING command 
XY parameter type 
XY-report parameter type 
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4010-HARDCOPY Command 

Host Syntax 




Setup Syntax 




l^pO/^DipXlrtKI II wpuuil » 15 lliaicineu, una ouininai iu uduScd andiu uvp) 

of the display to be sent to the interface selected with the 
The 401 0-HARDCOPY command is provided for com- SELECT-HARDCOPYINTERFACE command, 

patibility with host software written for use with earlier 

TEKTRONIX terminals. This command has the same effect REFERENCES 

as pressing the HARDCOPY key. A hard copy of the display " c 

is made on the hard copy unit (provided one is attached). H ARDCOPY command 

HARD COPY kev 
issuing the 4010-HARDCOPY command is equivalent to SELECT-HARDCOPYINTERFACE command 

issuing the HARDCOPY command with a parameter of 
zero: 

HARDCOPY: = E cKH0 
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4010-Status-Report Message Type 



SYNTAX 



.-,.„.. , (4010-GIN-status-report \ 

4010-status-report = { „ T . r y \ 

y 4010-non-GIN-status-report ) 

4010-GIN-status-report = 4010-xy-report 

EOM-indicator 

4010-non-GIN-status-report = 4010-status-byte 

4010-xy-report 
EOM-indicator 

401 0-status-byte = a seven-bit ASCII character whose high-order two bits are "01 " and whose least-significant five 
bits hold status information, described below. 

4010-xy-report = HiX-report 
LoX-report 
HiY-report 
LoY-report 



PARTS OF THE REPORT 

4010-GIN-status-report. 

If the terminal is enabled for graphic input, the report 
message does not include a 4010-status-byte. 

4010-non-GIN-status-report. 

If the terminal is not enabled for graphic input, the report 
message begins with a 4010-status-byte. 

4010-status-byte. 

A seven-bit ASCII character, in the range from s p to ? — a 
character whose two high-order bits are "01 ". The least- 
signicant five bits hold status information. 

4010-xy-report. 

Four ASCII characters holding 10-bit x- and 
y-coordinates for the location of the terminal's cursor. 



DESCRIPTION 

The 4010-status-report is sent by the 41 1 in response to a 
REPORT-4010-STATUS command (the E c E o sequence). It 
may also be sent if the terminal has received a ENABLE- 
4953-TABLET-GIN command and the operator moves the 
pen (or four-button cursor) away from the tablet surface. 



When the terminal sends a report to the host, it enters 
Bypass mode. (See the ENTER-BYPASS-MODE 
command.) 



Responding to a REPORT-4010-STATUS Command. If the 

terminal is responding to an e c e q sequence, it sends to the 
host either a 4010-GIN-status-report or a 4010-non-GIN- 
status-report, depending on whether or not it has been 
enabled for graphic input. 

If enabled for graphic input (with an ENABLE-4010-GIN or 
ENABLE-GIN command), the terminal responds to the e c e q 
by sending a 4010-GIN-status-report. This consists of four 
ASCII characters comprising a 4010-xy-report, followed 
optionally by an EOM-indicator. The 4010-xy-report holds 
1 0-bit x- and y-coordinates for the current position of the 
graphic cursor. 

If not enabled for graphic input, the terminal responds to an 
E c E o sequence by sending a 4010-non-GIN-status-report. 
This report is similar to the 4010-GIN-status-report, but with 
two differences. First, the report begins with a 4010-status- 
byte which holds status information about the terminal. 
Second, the 4010-xy-report gives the position, not of the 
graphic cursor, but of the terminal's alpha cursor. 
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Ten-Bit Precision. The 4010-xy-report gives the coordinates 
of some point in 4096-by-4096 terminal space, but it gives 
those coordinates with only ten-bit precision. That is, only 
the most significant ten bits of the x- and y-coordinates are 
sent to the host; the least significant two bits of those coordi- 
nates are omitted. Consequently, there may be an error 
of up to three terminal space units in the position that is 
reported to the host computer. 

If full twelve-bit precision is required, the ENABLE-GIN or 
REPORT-GIN-POINT command should be used, rather 
than the ENABLE-4010-GIN or REPORT-4010-STATUS 
command. 



401 0-Status-Byte. The 4010-status-byte is a seven-bit ASCII 
character. Its two most-significant bits are "01 ", and its 
least-significant bits hold status information about the 

ICI iilllldi, CIO iUIIOWO. 

b7 b6 b5 b4 b3 b2 b1 

1 HCU NOLI GRAPH MARGIN AUX-SENSE 



EOM-indicator. The EOM-indicator ("end-of-message" 
indicator) marks the end of the report. If the terminal is not 
in block mode, this is just the current EOL-string, as set by 
the most recent SET-EOL-STRING command. Typically, this 
is just the "carriage return" character, c r. For more details 
see EOM-indicator syntactic construct and SET-EOL- 
STRING command. To most closely emulate the 401 
Series terminals, the terminal should not be in block mode. 
The EOL-string should be set (by a (SET-EOL-STRING 
command). 

REFERENCES 

REPORT-401 0-STATUS command 



HCU 



NOLI.GRAPH 



MARGIN 



The HCU (Hard Copy Unit) bit, bit b5, is 
zero if a hard copy unit is attached to the 
terminal and is ready to accept a copy 
request. Otherwise, this bit is one. This bit 
reflects the status of the standard hard 
copy interface only, even if Option 9 (the 
color hard copy board and interface) is 
installed. 

In the 41 1 0, the NOLI (No Linear Interpo- 
lation) and GRAPH (Graph Mode) bits 

k Q „ A +u« <*%II A ...: „_:-„«. 

nave; tiro iuiiuvViiiij niceu III lyo. 

NOLI GRAPH 

The terminal is in marker mode. 

1 The terminal is in alpha mode. 

1 The terminal is in vector mode. 

1 1 (This combination does not occur.) 

On a 41 1 4 and 41 1 6, the MARGIN bit is 
zero if column 1 is in effect (that is, if the 
terminal has not "wrapped around" to 
column 2, column 3, etc.) The MARGIN 
bit is one if wrap-around has occurred, so 
that column 2, column 3, etc., is in effect. 
(See set-margin for details.) 

In the 41 1 2, 41 1 3, or 41 1 5, this bit is 
always zero. 



AUX-SENSE This bit is always one. 
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4953-Tablet-Gin-Report Syntactic Construct 



SYNTAX 



4953-tablet-GIN-report = 



header-char 



M 
J 
O 



4953-tablet-xy-report = 



\EOM-indicator] 
header-char 
4953-tablet-xy-report 
[EOM-indicator] 



i xy-report 

\ 10-bit-xy-report 



) 



10-bit-xy-report = 



HiY-report 
LoY-report 
HiX-report 
LoX-report 



PARTS OF THE REPORT 

EOM-indicator. 

An EOM-indicator is only sent at the start of the report 
message if both the following conditions are met: (a) At 
least one character has already been sent on this line 
(that is, since the last EOM-indicator). (b) If the current 
line were not terminated (by sending this EOM- 
indicator), then the rest of this 4953-tablet-GIN-report 
would cause the current maximum line length to be 
exceeded. 

An EOM-indicator is only sent at the end of the report 
message if the SET-REPORT-EOM-FREQUENCY 
command specified "more frequent" rather than "less 
frequent." 

header-char. 

A single ASCII character. The possible header charac- 
ters are determined by the most recent SET-TABLET- 
HEADER-CHARACTERS command. 

4953-tablet-xy-report. 

The ENABLE-4953-TAB LET-GIN command determines 
whether the cursor position is reported to 1 2 bits of preci- 
sion (in the standard xy-report format), or to only 1 bits 
of precision (in the 10-bit-xy-report format). 



10-bit-xy-report. 

Gives the most-significant 10 bits of the cursor's x- and 
y-coordinates. The format is similar to that of the stand- 
ard xy-report, except that the Extra-Report byte is omit- 
ted. 



DESCRIPTION 

By issuing the ENABLE-4953-TABLET-GIN command, you 
can cause the terminal to emulate a TEKTRONIX 401 
Series terminal with accessory 4953 or 4954 graphics 
tablet. (See the description of the ENABLE-4953-TABLET- 
GIN command for details.) 

In response to an ENABLE-4953-TABLET-GIN command, 
the 41 1 sends graphic input information to the host 
computer in a format compatible with the format used by 
TEKTRONIX 4953 or 4954 graphic tablets; this format com- 
prises the 4953-tablet-GIN-report. 

When the terminal sends a report to the host, Bypass mode 
is entered. (See ENTER-BYPASS-MODE.) 
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First EOM-lndicator. The optional EOM-indicator at the 
start of the report occurs in the syntax because of the 
terminai's "maximum report iine iength" feature. (See the 
description of the SET-REPORT-MAX-LINE-LENGTH 
command for details.) This EOM-indicator is prefixed to the 
report if it is needed to prevent the terminal's maximum line 
length from being exceeded. 



4953-Tablet-Xy-Report. The 4953-tablet-xy-report resem- 
bles the terminal's ordinary xy-report, described elsewhere 
in this section. However, if the ENABLE-4953-TABLET-GiN 
command specified only 10-bit data, then the Extra-report 
byte is omitted; in that case, the 4953-tablet-xy-report 
contains only four bytes, instead of the five found in ordi- 
nary xy-reports. 



If the terminal is not in block mode, the EOM-indicator is 
just the current EOL-string, as set by the most recent SET- 
EOL-STRiNG command. Typically, this is just the "carriage 
return" character, c r. For more details, see EOM-indicator 
syntactic construct and SET-EOL-3TRING command. To 
most closely emulate the 4010 Series terminals, the 
terminal should not be in block mode. The EOL-string 
should be set (by a SET-EOL-STRING command). 



Final EOM-lndicator. The EOM-indicator at the end of the 
report is sent if the most recent SET-REPORT-EOM- 
FREQUENCY command specified that reports are to 

ha cant "mrvra from lAnflii" rothoi 1 th^r** "laoe fi»^»i^i lArtilw " 

Typically, this EOM-indicator is just the c r character. 
REFERENCES 



Header-Char. The header-char is analogous to the "key" 
character in ordinary 41 1 0-style GIN-stroke-reports. Which 
characters are used for the header-char depends on the 
most recent SET-TABLET-HEADER-CHARACTERS 
command. If the int parameter in that command was 0, then 
the header-char is one of the ASCII control characters G s, 
s b, and u s. If the int parameter in that command was 1 (the 
default), then the header-char is one of the uppercase letters 
M, J, andO. 



ENABLE-4953-TABLET-GIN command 
ENTER-BYPASS-MODE command 
EOM-indicator syntactic construct 
SET-REPORT-EOM-FREQUENCY command 
SET-REPORT-SIG-CHARS command 
4953-tablet-xy-report message type 
XY-report syntactic construct 



For the first point in a stroke, the header-char is G s or M. For 
subsequent points in a stroke, the header-char is s b or J. 
For the last point in a stroke (when the operator ceases to 
press the pen against the tablet), the header-char is u s or O. 
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Section 8 



ANSI X3.64 Commands 



INTRODUCTION 



ANSI SYNTAX 



The terminal is equipped with two command sets. This 

ad^iiuR uidouaacs n 10 r-u^or aj.u^ oui iiniai iuo \nnoi muuc 

as set by the SELECT-CODE command). 



TERMINAL MODES 

Terminal modes (e.g. Overstrike/Replace, Echo, etc) remain 
set in ANSI modes even though they were set while the 
terminal was in TEK mode. Terminal modes set while the 
terminal is in ANSI mode remain set after the terminal 
returns to TEK mode. 



CONTROL CHARACTERS 

The terminal reacts to a different set of control characters 
while processing a command in ANSI mode. All control 
characters that do not prompt a terminal or cursor action 
(including the TEK mode command terminators) are 
ignored, and the control characters that do prompt an action 
cause that action without terminating the command. (These 
control characters are b l, b s, h t, l f, v t, f f, and c r.) For exam- 
ple, the b l character causes the terminal bell to ring, the c r 
character causes the action as set by CRLF mode, etc. 

This section does not describe control characters that are 
not ignored and that have the same action in both modes. 
For discussion of the actions of these characters, see 
Section 7. 



The ANSI X3.64 commands that are in Section 8 use a 

unictci 11 oyi lldA LI ICZI I II IC I I— 1\ \t\J\\ II IICU IVJO II I VJCOLIU1 I I . 

These commands are only valid on 41 1 2, 41 1 3, and 41 1 5 
terminals (not 41 1 4 or 41 1 6 terminals), and only in the dia- 
log areas of these terminals (not in the graphics area). ANSI 
commands (including alphatext) affect only the dialog area, 
whether the dialog area is enabled or not. 

There are two syntax forms for the ANSI commands. Com- 
mands of one of these syntax forms consist of an E c charac- 
ter and a unique final character. The final character is what 
identifies each command. The commands with this syntax 
form do not have parameters. 

Commands of the other syntax form consist of a control- 
sequence-introducer (CS1), zero or more parameters of 
either Pn or Ps types, and a unique final character. The CSI 
and the terminator together identify individual commands. 

The CSI syntax is: 
E c[ 

Substitute these two characters whenever the CSI'is 
called for. 

The symbols that are used to represent syntax elements 
and conventions for ANSI commands are the same as those 
used for TEK commands (see Table 2-1). 
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ANSI PARAMETER TYPES 



COMMAND TERMINATORS 



There are two parameter types for ANSI X3.64 commands, 
Pn and Ps. 



Pn 



Pn is a numeric parameter ranging from to 32767. Send 
Pn's as a sequence of digits. For example, send the number 
75 as the two characters 7 and 5. There is no special pack- 
ing scheme for this parameter type. If the Pn is or missing 
it is interpreted as 1 unless it is part of a Ps parameter. 



ANSI mode uses the c n and s b characters as command 
terminators. When these characters are received in the 
middle of a command, the command is terminated and any 
characters belonging to that command that have already 
been received are discarded. When this occurs, a snoopy 
character c n or s b will appear on the terminal screen. 



Ps 



Ps is a parameter selected from a given list. When the 
parameter type is Ps, the command description gives you a 
choice of parameters. There is no special packing scheme 
for this parameter type. They all have the format of a Pn or 
(char),Prt where (char) is <, :, >, or ?. 

The semicolon (;) separates parameters in a command 
string. Enter a semicolon between parameters when you 
are entering more than one parameter for a command. You 
can enter up to 46 characters of Ps parameters for a corn- 
mad that expects Ps parameters. 
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ANSI/VT52-MODE Command 



c n Character 



SYNTAX 



c c< 



DESCRIPTION 

This command is treated as a no-op by the terminal, but is 
included for compatibility with certain editors. 



DESCRIPTION 

This character is a command terminator. When it is received 
in the middle of a command, the command is terminated 
and any characters belonging to that command that have 
already been received are discarded. When this occurs, a 
snoopy character c n will appear on the terminal screen. 

The s b character has the same effect. 



REFERENCES 

s b character 
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Control-Sequence-lntroducer 



CURSOR-BACKWARD Command 



Acronym: CSI 



SYNTAX 




Acronym: CUB 
SYNTAX 



CSI [Pn:number-of-columns] D 



DESCRIPTION 

The control-sequence-introducer, CSI, serves to introduce 
control sequence type commands. (Many ANSI X3.64 
commands are of the control sequence type.) 



PARAMETERS 

number-of-columns (0 to 32767) 

The number of columns to move the cursor to the left. 



DESCRIPTION 

This command causes the cursor to move to the left the 
specified number of columns in the active line. 

If the number-of-columns parameter is greater than the 
number of columns to the left of the cursor position, the 
cursor moves to column 1 (the left-most column) in the 
current line. 



DEFAULT 

number-of-columns 
if or omitted — 1 



ERRORS 

[D11 (Level 2): Invalid number-of-columns parameter 
(range is to 32767). 
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CURSOR-BACKWARD-TAB 
Command 

Acronym: CBT 
SYNTAX 



CSI [Pn:number-of-tabs] Z 



PARAMETERS 

number-of-tabs (0 to 32767) 

The number of tab stops to move the cursor backward. 



DESCRIPTION 

This command causes the cursor to move backward (to the 
left) the specified number-of-tabs \&b stops on the current 
line. 

If a parameter value of n is received, the cursor moves back 
to the nth tab stop preceding or column 1 of the current line, 
whichever comes first. No wrap-around occurs. 



DEFAULTS 

number-of-tabs 
if or omitted — 1 

ERRORS 

[Z1 1 (Level 2): Invalid number-of-tabs parameter (range 
is to 32767). 

REFERENCES 

CURSOR-HORIZONTAL-TAB command 
h t character 



CURSOR-DOWN Command 

Acronym: CUD 
SYNTAX 



CSI [Pn:number-of-lines] B 



PARAMETERS 

number-of-lines (0 to 32767) 

The number of lines to move the cursor down. 



DESCRIPTION 

This command causes the cursor to move down the number 
of lines (rows) specified in the number-of-lines parameter. 

If the CUD command moves the cursor from inside the 
viewport (the visible area of the dialog area) to below the 
viewport, or from above the viewport to below the viewport, 
then the text scrolls so as to keep the cursor in view. 

If the cursor was not inside the viewport when the command 
is received it becomes visible only if it is moved through the 
viewport. 

If the number of lines specified is greater than the number 
of lines of text remaining in the scroll buffer (as set by the 
SET-DIALOG-AREA-BUFFER-SIZE command), the cursor 
stops at the bottom of the scroll buffer. 

DEFAULT 

number-of-lines 
if or omitted — 1 



ERRORS 

[B11 (Level 2): Invalid number-of-lines parameter (range 
is to 32767). 



REFERENCES 

SET-DIALOG-AREA-BUFFER-SIZE command 
(TEK command set) 
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CURSOR-FORWARD Command 

Acronym: CUF 
SYNTAX 



CSI [Pn:number-of-columns] C 



PARAMETERS 

number-of-columns (0 to 32767) 

The number of columns to move the cursor forward. 



DESCRIPTION 

This command causes the cursor to move to the right the 
number of columns specified by the number-of-columns 
parameter. 

If the number received is greater than the number of 
columns to the right of the cursor position in the current 
line, the cursor moves to the right-most column. 

DEFAULT 

number-of-columns 
if or omitted — 1 



ERRORS 

[C11 (Level 2): Invalid number-of-columns parameter 
(range is to 32767). 



CURSOR-HORIZONTAL-TAB 
Command 

Acronym: CHT 
SYNTAX 




PARAMETERS 

number-of-tabs (0 to 32767) 

The number of tab stops to move the cursor forward. 



DESCRIPTION 

This command moves the cursor to the right number-of-tabs 
tab stops on the current line. 

If the parameter value is 1 (or or omitted), the cursor 
moves forward to the tab stop immediately following the 
current cursor position. If a parameter value of n is received, 
the cursor moves forward to the nth tab stop following, or to 
the right-hand margin of the current line, whichever comes 
first. No wrap-around occurs. 

DEFAULTS 

number-of-tabs 
if or omitted — 1 



ERRORS 

[11 1 (Level 2): Invalid number-of-tabs (range is 
to 32767). 



REFERENCES 

CURSOR-BACKWARD-TAB command 
h t character 
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CURSOR-POSITION Command 

Acronym: CUP 
SYNTAX 



CSI [Pn:line-number] [; 

[Pr\:coIumn-number]] H 



If line-number is greater than the number of lines in the 
scroll buffer (as set by the SET-DIALOG-AREA-BUFFER- 
SIZE command), the cursor is positioned at the bottom 
of the scroll buffer. If column-number is greater than the 
number of columns in the scroll buffer (as set by the SET- 
DIALOG-AREA-CHARS command), the cursor is positioned 
at the right-most column. 

DEFAULT 

line-number 

if n nr nmjttfid — 1 



PARAMETERS 

line-number (0 to 32767) 

The number of the line to which to move the cursor. 

column-number (0 to 32767) 

The number of the column to which to move the cursor. 



DESCRSPTION 

This command moves the cursor to the line and column 
within the scroll buffer specified in the line-number and 
column-number parameters. 

If the specified coordinates move the cursor from inside the 
dialog area viewport to coordinates that are currently out- 
side the viewport, the text scrolls so that the cursor remains 
in view. This scrolling does not occur if the cursor moves 
from outside the viewport to another position outside the 
viewport. 



column-number 
if or omitted — 1 



ERRORS 

[H1 1 (Level 2): Invalid line-number parameter (range is 
to 32767). 

[H21 (Level 2): Invalid column-number parameter (range 
is to 32767). 



REFERENCES 

SET-DIALOG-AREA-BUFFER-SIZE command 

(TEK command set) 
SET-DIALOG-AREA-CHARS command (TEK command set) 
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CURSOR-POSITION-REPORT 
Message Type 

Acronym: CPR 
SYNTAX 



CSI Pxwline-number ; 

Pxv.column-number R 



PARAMETERS 

line-number 

The number of the line the cursor is in. 

column-number 

The number of the column the cursor is in. 

DESCRIPTION 

The terminal sends this response to the host when it 
receives the DEVICE-STATUS-REPORT command with 
a device parameter of 6. 

The message contains the line (row) and column coordi- 
nates of the cursor position in the scroll buffer. "Line 1, 
column 1 " indicates the upper left-hand comer of the scroll 
buffer. 

When the terminal sends this message, it does not append 
an EOM-character or enter Bypass mode. 

REFERENCES 

DEVICE-STATUS-REPORT command (ANSI command set) 



CURSOR-UP Command 

Acronym: CUU 
SYNTAX 




PARAMETERS 

number-of-lines (0 to 32767) 

The number of lines to move the cursor up. 

DESCRIPTION 

This command moves the cursor up the number of lines 
specified in the number-of-lines parameter. 

If the cursor moves from inside the viewport to a position 
currently above the viewport, or from below the viewport to 
above the viewport, then the text scrolls so as to keep the 
cursor in view. 

If the cursor was not inside the viewport when the command 
was received, it only becomes visible if it is moved through 
the viewport. 

If the number-of-lines parameter specified is greater than 
the number of lines of text remaining in the scroll buffer, the 
cursor stops at the first line in the scroll buffer. 



DEFAULT 

number-of-lines 
if or omitted — 1 



ERRORS 

[A1 1 (Level 2): Invalid number-of-lines parameter (range 
is to 32767). 
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DELETE-CHARACTER Command 



DELETE-LINE Command 



Acronym: DCH 
SYNTAX 



CSI [Pn:number-of-characters] P 



Acronym: DL 
SYNTAX 



CSI [Pn:number-of-lines] M 



PARAMETERS 

number-of-characters (0 to 32767) 

The number of characters to be deleted. 



PARAMETERS 

number-of-lines (0 to 32767) 

The number of lines to be deleted. 



DESCRIPTION 

This command deletes number-of-characters characters 
from the current line, starting at the current cursor position. 
Only characters on the current line of text are deleted, even 
if number-of-characters is larger than the number of of char- 
acters remaining on the line. 

Characters to the right of the deleted characters in the cur- 
rent line are moved to the left so that there is no gap left in 
the line. The characters from the next line are not moved up 
to fill the empty spaces left by this command. 

The cursor position does not change. 



DEFAULT 

number-of-characters 
if or omitted — 1 



ERRORS 

[P1 1 (Level 2): Invalid number-of-characters parameter. 



DESCRIPTION 

This command deletes number-of-lines lines from the scroll 
buffer, starting at the current line. 

If the number-of-lines parameter less one is equal to or 
greater than the remaining number of lines in the scroll 
buffer, the remainder of the scroll buffer, including the line 
holding the cursor, is deleted. 

All lines in the scroll buffer following the deleted lines are 
shifted up, so that the line immediately following the deleted 
lines becomes the current line (contains the cursor). 

All lines following the shifted portion are erased (i.e., the 
text in the shifted lines is not repeated). 

The cursor position does not change. 



DEFAULT 

number-of-lines 
if or omitted — 1 



ERRORS 

[M11 (Level 2): Invalid number-of-lines parameter (range 
is to 32767). 
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DEVICE-STATUS-REPORT Command DISABLE-MANUAL-INPUT Command 



Acronym: DSR 
SYNTAX 



CSI Ps:device n 



Acronym: DMI 
SYNTAX 




PARAMETERS 

device 

The device whose status report you want. Valid 
devices are: 

6 cursor position 



DESCRIPTION 

This command causes the terminal to send a device report 
to the host computer. The only report available at this time is 
a report on cursor position. 

DEFAULT 

device 

as shipped — none 
on power-up — none 
if omitted — error [n1 1 

ERRORS 

[n11 (Level 2): Invalid efev/ce parameter; the only valid 
device specifier is 6. 

REFERENCES 

Cursor-position-report message type 



DESCRIPTION 

This command locks the keyboard. When the keyboard is 
locked, pressing any key except CANCEL and BREAK rings 
the terminal bell. 

This command has the same effect as the LOCK- 
KEYBOARD: 1 command. 



REFERENCES 

ENABLE-MANUAL-INPUT command 
LOCK-KEYBOARD command (TEK command set) 
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ENABLE-MANUAL-INPUT Command ERASE-CHARACTER Command 



Acronym: DM I 
SYNTAX 




Acronym: ECH 
SYNTAX 



CSI \Pn\number-of-characters\ X 



DESCRIPTION 

This command unlocks the terminal keyboard. It has the 
same effect as the LOCK-KEYBOARD: command. 



PARAMETERS 

number-of-characters (0 to 32767) 

The number of characters to be erased. 



REFERENCES 

DISABLE-MANUAL-INPUT command 
LOCK-KEYBOARD command (TEK command set) 



DESCRIPTION 

This command erases number-of-characters characters 
starting at the current cursor position. 

As many characters are erased as are specified in the 
number-of-characters parameter, including characters in the 
lines that follow the line that holds the cursor (unlike the 
characters deleted by the DELETE-CHARACTER com- 
mand). The erasure of characters in a new line begins in 
column 1 of that line. 

Characters that follow the erased characters are not shifted 
forward to fill the emptied spaces; that is, characters are 
removed from the scroll buffer, but the character cell is not 
deleted. 

The cursor position does not change. 

DEFAULT 

number-of-characters 
if or omitted — 1 



ERRORS 

[X1 1 (Level 2): Invalid number-of-characters parameter 
(range is to 32767). 

REFERENCES 

DELETE-CHARACTER command 
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ERASE-IN-DISPLAY Command 



ERASE-IN-LINE Command 



Acronym: ED 
SYNTAX 




Acronym: EL 
SYNTAX 



CSr [Ps.erase-extent] K 



PARAMETERS 

erase-extent 

The part of the scroll to be erased. Valid selectors are: 

from the cursor through the end of the 
scroll buffer, including the cursor position. 

1 from the beginning of the scroll buffer to 
and including the cursor 

position. 

2 the entire scroll buffer 



PARAMETERS 

erase-extent 

The part of the line to be erased. Valid selectors are: 

from the cursor position to the right-most 
occupied column, including the cursor 
position. 

1 from column 1 to and including the cursor 
position. 

2 the entire line. 



DESCRIPTION 

This command causes all or part of the scroll to be erased, 
with the erased portion determined by the erase-extent 
parameter and the cursor position. 

Characters that follow the erased portion of the scroll are 
not shifted forward to fill the emptied spaces; that is, charac- 
ters are removed from the scroll buffer, but the character 
cell is not deleted. 

The cursor position does not change. 



DESCRIPTION 

This command causes all or part of a line to be erased, with 
the erased part determined by the erase-extent parameter 
and the cursor position. 

Characters that follow the erased portion of the scroll are 
not shifted forward to fill the emptied spaces; that is, charac- 
ters are removed from the scroll buffer, but the character 
cell is not deleted. 

The cursor position does not change. 



DEFAULT 

erase-extent 

as shipped — none 
on power-up — none 
if omitted — 



DEFAULT 

erase-extent 

as shipped — none 
on power-up — none 
if omitted — 



ERRORS 

[J 1 1 (Level 2): Invalid erase-extent parameter (must be 
0, 1,or2). 



ERRORS 

[K1 1 (Level 2): Invalid erase-extent parameter (must be 
0,1, or 2). 
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f f Character 



DESCRIPTION 

When the terminal receives this character in ANSI mode, it 
acts as if it had received an l f character. 



REFERENCES 

l f character 



HORIZONTAL-AND-VERTICAL- 
POSITION Command 

Acronym: HVP 
SYNTAX 



CSI [PnJine-number] [; 

[Pn.column-number]] f 



PARAMETERS 

The number of the row to which to move the cursor. 

column-number (0 to 32767) 

The number of the column to which to move the cursor. 



DESCRIPTION 

This command moves the cursor to the line and column 
coordinates specified in the line-number and column- 
number parameters. 

If the cursor moves from or through the current viewport 
to a position outside the current viewport, the viewport 
is scrolled up or down such that the cursor remains or 
becomes visible. The new cursor position is either at the 
bottom or top of the viewport, depending on the direction of 
the scroll action and on which edge of the viewport was 
closer to the old cursor position. 

DEFAULT 

line-number 

if or omitted — 1 

column-number 
if or omitted — 1 



ERRORS 

[f 1 1 (Level 2): Invalid line-number parameter (range is 
to 32767). 

[f21 (Level 2): Invalid column-number parameter (range 
is to 32767). 
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HORIZONTAL-TAB-SET Command 



h t Character 



Acronym: HTS 
SYNTAX 




DESCRIPTION 

This command sets a tab stop at the current cursor position. 
The tab position is set in the current column, and is set for 
all lines (not just the current line). 

REFERENCES 

h t character 
TABULATION-CLEAR command 



DESCRIPTION 

If the terminal receives an h t character while in ANSI mode, 
the cursor moves to the right to the next tab stop set by the 
HORIZONTAL-TAB-SET command, or to the right-most 
column in the current line, whichever comes first. 



REFERENCES 

HORIZONTAL-TAB-SET command 
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INDEX Command 



INSERT-CHARACTER Command 



Acronym: IND 
SYNTAX 




Acronym: ICH 
SYNTAX 




DESCRIPTION 

This command causes the cursor to move down one line 
without changing column position. 

if the cursor is on the bottom Nne of the viewport, but is not 
on the bottom line of the scroll buffer, the text is scrolled up. 
If the cursor is at the bottom line of the scroll buffer, a blank 
line is added to the bottom of the scroll, the top line of the 
scroll buffer is removed, and the text is then scrolled up. 

If a line is removed at the top of the scroll buffer, the remain- 
ing lines in the scroll buffer are renumbered. 



PARAMETERS 

number-of-characters (0 to 32767) 

The number of empty spaces to be inserted. 

DESCRIPTION 

This command shifts the character currently at the cursor 
position and the characters to its right number-of-characters 
positions to the right. Characters shifted off the end of the 
line are lost. 

The cursor position does not change. 



DEFAULTS 

number-of-characters 
if or omitted — 1 



ERRORS 

[@ 1 1 (Level 2): Invalid number-of-characters parameter 
(range is to 32767). 
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INSERT-LINE Command 



NEXT-LINE Command 



Acronym: IL 
SYNTAX 



CSI [Pn:number-of-lines] L 



Acronym: NEL 
SYNTAX 




PARAMETERS 

number-of-lines (0 to 32767) 

The number of blank lines to be inserted. 



DESCRIPTION 

This command inserts number-of-lines empty lines at the 
cursor position. The line that contains the cursor and all 
succeeding lines in the scroll buffer are shifted downward. 
The last lines in the scroll buffer are lost if the scroll buffer 
is full. 

The cursor position does not change. 



DESCRIPTION 

This command causes a carriage return/line feed action, 
moving the cursor to the beginning of the next line. 

If the cursor is on the bottom line of the viewport, but is not 
on the bottom line of the scroll buffer, the text is scrolled up. 
If the cursor is at the bottom line of the scroll buffer, a blank 
line is added to the bottom of the scroll, the top line of the 
scroll buffer is removed, and the text is then scrolled up. 



DEFAULT 

number-of-lines 
if or omitted — 1 



ERRORS 

[L1 1 (Level 2): Invalid number-of-lines parameter (range 
is to 32767). 
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RESET-MODE Command 

Acronym: RM 
SYNTAX 



CSI [Ps.mode [; [Ps:mode]...]] I 



PARAMETERS 

mode 

The terminal mode you want to reset. Valid selectors are: 

Selector Mode Action 

2 Keyboard Action Unlocks the keyboard; 

same as ENABLE- 
MANUAL-INPUTand 
LOCK-KEYBOARD: 



12 



20 



?7 



?8 



Insertion/ 


Existing characters are 


Replacement 


replaced as new charac- 




ters are entered. 


Send/Receive 


Sets the terminal to local 




echo (Echo mode is 




turned on). 


Linefeed/Newline 


l f characters received 




move the cursor down 




only. (LFCR mode 




turned off). 


Overstrike/ 


Sets diaiog-area-writing- 


Replace 


mode to Overstrike mode 



Auto-wrap Disables the auto-wrap 

feature — the cursor does 
not automatically wrap to 
the next line at the end of a 
line of data. 

Auto-repeat Keys do not automatically 

repeat when held down. 



DESCRIPTION 

This command resets the action of various terminal modes. 

Reset is the default for the following modes: 

• Keyboard Action mode 

• Insertion/Replacement mode 

• Overstrike/Replace mode 

• Linefeed/Newline mode 

Once a mode is reset, it remains reset until set by a SET- 
MODE command, by a command affecting that particular 
mode is received, or until a RESET-TO-INITIAL-STATE 
command is received. 

ERRORS 

[M 1 (Level 2): invalid or missing mode value. 

REFERENCES 

ECHO command (TEK command set) 

INDEX command 

LFCR command (TEK command set) 

LOCK-KEYBOARD command (TEK command set) 

RESET-TO-INITIAL-STATE command 

SET-DIALOG-AREA-WRITING-MODE command 

(TEK command set) 
SET-MODE command 
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RESET-TO-INITIAL-STATE Command RESTORE-CURSOR Command 



Acronym: RIS 
SYNTAX 



Acronym: TEKRC 



SYNTAX 





DESCRIPTION 

This command causes the terminal to go through its power- 
up initialization. 

This command has the same effect as pressing the 
MASTER RESET button or entering the RESET command. 



REFERENCES 

RESET command (TEK command set) 



DESCRIPTION 

This command restores the cursor position and graphic 
rendition previously saved with the SAVE-CURSOR com- 
mand. If the SAVE-CURSOR command was not used to 
save the cursor position, the cursor is moved to the upper 
left corner of the scroll buffer (line 1 , column 1 ), and the 
graphic rendition is set to the default (plain text). 

REFERENCES 

SAVE-CURSOR command 
SET-GRAPHIC-RENDITION command 
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REVERSE-INDEX Command 



SAVE-CURSOR Command 



Acronym: Rl 
SYNTAX 




Acronym: TEKSC 



SYNTAX 




DESCRIPTION 

This command moves the cursor up one line up without 
changing the column position. 

If the cursor is at the top of the viewport, but is not at the top 
of the scroll buffer, the text is scrolled down and the cursor 
remains in the viewport. 

If the cursor is at the top of the viewport and is also at the 
top of the scroli buffer, a biank line is added to the top of the 
scroll and the buffer is scrolled down. If the scroll buffer is 
full the last line of data is lost. 



DESCRIPTION 

This command causes the terminal to save the present 
cursor position and graphic rendition. 

You can restore the saved information with the RESTORE- 
CURSOR command. 



REFERENCES 

RESTORE-CURSOR command 
SET-GRAPHIC-RENDITION command 
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s b Character 



SCROLL-DOWN Command 



DESCRIPTION 

This character is a command terminator. When it is received 
in the middle of a command, the command is terminated 
and any characters belonging to that command that have 
already been received are discarded. When this occurs, a 
snoopy character s b appears on the terminal screen . 

The c n character has the same effect. 



REFERENCES 

c n character 



Acronym: SD 
SYNTAX 



CSI \Pn:number-of -lines] T 



PARAMETERS 

number-of-lines (0 to 32767) 

The number of lines to be scrolled. 



DESCRIPTION 

This command shifts the scroll buffer down within the dialog 
area viewport the specified number of lines. Lines at the 
bottom of the viewport are scrolled out of the view as lines 
appear at the top. 

Scrolling stops when number-of-lines lines have been 
scrolled or when the top line of the scroll buffer is at the top 
of the viewport. 

The cursor position within the scroll buffer does not change, 
so this command may move the cursor out of view. 



DEFAULT 

number-of-lines 
if or omitted — 1 



ERRORS 

[T1 1 (Level 2): Invalid number-of-lines parameter (range 
is to 32767). 

REFERENCES 

SCROLL-UP command 
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SCROLL-UP Command 

Acronym: SU 
SYNTAX 




PARAMETERS 

number-of-lines (0 to 32767) 

The number of lines to be scrolled. 



DESCRIPTION 

This command shifts the scroll buffer up within the dialog 
area viewport by the specified number of lines. Lines at the 
top of the viewport are scrolled out of view as lines appear 
at the bottom. 

Scrolling stops when number-of-lines lines have been 
scrolled or when the bottom line of the scroll buffer is in 
view. 

The cursor position within the scroll buffer does not change, 
so this command may move the cursor out of view. 



SELECT-CHARACTER-SET 
Command 

Acronym: SCS 
SYNTAX 



E c( (char) 
E c\ (charl 



DESCRIPTION 

• His cornrnarivj is recognized, but ignored. It is included for 
compatibility with other terminals. 



nccAi II T 

number-of-lines 
if or omitted — 1 



ERRORS 

[S1 1 (Level 2): Invalid number-of-lines parameter (range 
is to 32767). 

REFERENCES 

SCROLL-DOWN command 
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SELECT-CODE Command 



Host Syntax 



E c%! mWcommand-set 



Setup Syntax 



CODE s p command-set 



DESCRIPTION 

This command causes the terminal to recognize the com- 
mands of either the ANSI X3.64 or the TEKTRONIX 4100 
System, depending on the selected parameter. Since the 
syntaces of the two command sets are different and over- 
lapping, the terminal recognizes only one command set at 
a time. 

Setup mode has a separate command parser, and is there- 
fore not affected by this command. 

When TEK mode is selected, this command puts the termi- 
nal into Alpha mode. 



DEFAULTS 



PARAMETERS 

command-set (0 or 1 ) 

Specifies which command set is valid for the terminal. 
Setup mode parameters are TEK and ANSI. 

TEK command set 

1 ANSI X3.64 command set 



command-set 
as shipped — 
on power-up — 
if omitted — 



ERRORS 



%!00 (Level 0): Unrecognized command; terminal firm- 
ware is Version 3. 

%!11 (Level 2): Invalid command-set (must be or 1.) 



REFERENCES 

ENTER-ALPHA-MODE command (TEK command set) 
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SELECT-GRAPHIC-RENDITION 
Command 

Acronym: SGR 
SYNTAX 



CSI [Ps.rendition [; [Ps.rendition]...]] m 



PARAMETERS 



rendition 

The sty!8{s) in vvhic 



i y v>u «iaii4 lo/\l iri icii auioio iu appeal, 



Valid specifiers are: 

primary rendition (default): no blink, no 
underscore, positive image, current 
dialog area foreground index 

1 alternate foreground index (bold) 

4 underscore 

5 slow blink 

7 reverse image: foreground and back- 

ground indices are interchanged 



The alternate foreground index (bold) is that set by the SET- 
DIALOG-AREA-ALTERNATE-INDEX command. 

If you include rendition in the list of rendition specifiers, all 
renditions previously set in the same list are cancelled, and 
only the specifiers that occur following the occurance of 
rendition are executed. 



DEFAULT 



rendition 

CK7 Ol l!p 

on power-up — 
if omitted — 



ERRORS 

[m11 (Level 2): Invalid rendition parameter. 

REFERENCES 

RESET-TO-INITIAL-STATE command 
RESTORE-CURSOR command 
SAVE-CURSOR command 

SET-DIALOG-AREA-ALTERNATE-INDEX command 
(TEK command set) 



DESCRIPTION 

This command invokes the graphic rendition that is speci- 
fied by the rendition parameters. All following characters in 
the data stream are displayed according to the specified 
parameters until the next occurrence of a SET-GRAPHIC- 
RENDiTION command, a RESTORE-CURSOR command, 
or a RESET-TO-INITIAL-STATE command. 



41 10 SERIES COMMAND REFERENCE 



8-23 



ANSI COMMANDS 



SET-MODE Command 

Acronym: SM 
SYNTAX 



CSI [Ps:mode [; [Ps.mode]...]] h 



PARAMETERS 

mode 

The terminal mode you want to reset. Valid selectors are: 

Selector Mode Action 

2 Keyboard Action Locks the keyboard. Same 

as DISABLE-MANUAL- 
INPUT and LOCK- 
KEYBOARD: 1 



12 



20 



Insertion/ 
Replacement 



Send/Receive 



Linefeed/Newline 



As new characters are 
entered, existing charac- 
ters are moved to the right, 
being lost off the right 
edge. 

Sets the terminal to remote 
echo (Echo mode off) 

l f characters received 
move the cursor and to 
column one of the next line 
(LFCR mode on) 



>1 


Overstrike/ 


Dialog-area-writing-mode 




Replace 


set to Replace. 


?7 


Auto-wrap 


Enables the auto-wrap 
feature — the cursor 
automatically wraps to the 
next line at the end of a 
line of data. 



DESCRIPTION 

This command sets the action of various terminal modes. 

Set is the default for the following modes: 

• Auto-wrap mode 

• Auto-repeat mode 

Once a mode is set, it remains set until reset by a RESET- 
MODE command, a command that affects that particular 
mode, or a RESET-TO-INITIAL-STAT command. 

You can set as many terminal modes as you want with one 
SET-MODE command. 

ERRORS 

[h11 (Level 2): Invalid or missing mode value. 

REFERENCES 

DISABLE-MANUAL-INPUT command 
ECHO command (TEK command set) 
LFCR command (TEK command set) 
LOCK-KEYBOARD command (TEK command set) 
RESET-MODE command 
SET-DIALOG-AREA-WRITING-MODE command 
(TEK command set) 



?8 



Auto-repeat 



Most keys automatically 
repeat when held down. 
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TABULATION-CLEAR Command 



't Character 



Acronym: TBC 
SYNTAX 



CSI [Ps:tab-clear-extent] g 



PARAMETERS 

tab-clear-extent 

Defines the tab stops you want cleared. Valid 
selectors are: 

Clear the tab stop at the cursor position 

2 Clear all tab stops in the active line (same 
as 3). 

3 Clear all tab stops (same as 2). 



DESCRIPTION 

This command clears one or all tab stops, according to the 
selected tab-clear-extent parameter. 

If you select 0, clear the tab at the cursor position, and there 
is no tab at the cursor position, the command is ignored. 



DEFAULT 

tab-clear-extent 
as shipped — none 
on power-up — none 
if omitted — 



ERRORS 

[g11 (Level 2): Invalid tab-clear-extent parameter. 

REFERENCES 

HORIZONTAL-TAB-STOPS command 



DESCRIPTION 

When the terminal receives this character in ANSI mode, it 
acts as if it had received an INDEX command. 



REFERENCES 

INDEX command 
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ASCI! CODE CHARTS 



This appendix includes a standard ASCII code chart and 
additional ASCII code charts which define the specific char- 
acters used as parameters (indicated by unshaded areas). 



The code charts are: 

Table Description 

A-1 ASCII Code Chart 

A-2 Characters Used in Char Parameters 

A-3 Characters Used in Int Parameters 

A-4 Characters Used in Int-Report and Intc-Report 

Parameters 

A-5 Characters Used in Xy Parameters 

A-6 Characters Used in Xy-Report Parameters 



Table A-1 
ASCII (IS0-7-US) CODE CHART 





B7 

B6 


B5 


^ 


S 


i 




^1 


1 % 


S 


'% 


'■, 


BITS 

B4 B3 B2 Bl 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














Nil 




DL 

16 


SP 

32 




48 


@ 

64 


P 

80 


\ 

96 


P 

112 











1 


SH 

1 


D1 

17 


I 

33 


1 
49 


A 

65 


«« 


a 

97 


q 

113 








1 





sx 

2 


D2 

18 


it 

34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

7 74 








1 


1 


EX 

3 


D3 

19 


# 
35 


3 

51 


c 

67 


s 

83 


c 

99 


s 

775 





1 








ET 

4 


D4 

20 


$ 

36 


4 

52 


D 

68 


T 

84 


d 

700 


t 
776 





1 


1 


EQ 

5 


NK 

21 


% 
37 


5 

53 


E 

69 


u 

85 


e 

101 


u 

117 





1 


1 '0 


AK 

6 


SY 

22 
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38 


6 

54 


F 

70 


V 

86 


f 

702 


V 

778 


1 11 1 


BL 

7 


EB 

23 


/ 

39 


7 

55 


G 

71 


w 

87 


g 

103 


w 

779 


1 0!0 


BS 

8 


CN 

24 


( 

40 


8 

56 


H 

72 


X 

88 


h 

704 


X 

720 


t ; a ; o ; -i 


HT 

9 


EM 

25 


) 

41 


9 

57 


I 

73 


Y 

89 


i 

705 


y 

727 


1 -0 1 


LF 

10 


SB 

26 


* 

42 


58 


J 

74 


z 

90 


J 

706 


z 

722 


1 0|i 1 


VT 

11 


EC 

27 


+ 
43 


5 

59 


K 

75 


[ 
97 


k 

707 


{ 

123 


1 n |e ,0 


FF ^ 


FS 

28 


) 


< 


L 

76 


\ 

92 


I 


I 

124 


1 ' 1 


1 


CR 

73 


GS 

29 


45 


6? 


M 

77 


] 

93 


m 

709 


} 
125 


1 iji ;0 


SO 

14 


RS 

30 


46 


>„ 


N 

78 


A 

94 


n 

770 


726 


iii 


1|1 


SI 

15 


US 

L._. 31 


/ 

47 


? 

63 




79 


~ ?1 




771 


DT 

727 



41 10 SERIES COMMAND REFERENCE 



A-1 



ASCII CODE CHARTS 



Table A-2 
CHARACTERS USED IN CHAR PARAMETERS 





l)5 
65 


% 


■ , 


>< 


, 


'M% 


«i 


l" \ 


CONTROL FIGURES UPPERCASE LOWERCASE 


0(0 








NU 


! DL 

1- ?6 


SP 

32 




48 


@ 

64 


P 

80 


\ 
96 


P 

772 











n 


■ 


01 
If 


! 

33 


1 

49 


A 

65 


Q 

81 


a 

97 


q 

773 








1 





r sx 

2 


D2 


n 

34 


2 

50 


B 

L 66 


R 

82 


b 

98 


r 

774 








1 


■ 


EX 

3 


03 

13 


# 
35 


3 

51 


c 

67 


s 

83 


c 

99 


s 

775 





' 








ET 

4 


04 

20 


$ 

l 36 


4 

52 


D 

68 


T 

84 


d 

too 


t 

776 





I 





1 


r EQ 

5 


NK 


% 
37 


5 

53 


E 

69 


u 

85 


e 

707 


u 

777 





61 


1 





^ AK 

6 


SY 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 

702 


V 

778 





If 


1 


IS 


BL 

7 


£B 

23 


1 

39 


7 

55 


G 

77 


w 

87 


g 

703 


w 

L 119 


1 











68 


CN 

24 


( 

40 


8 

56 


H 

72 


X 

88 


h 

704 


X 

720 


i 








"I 


HI 


EM 

25 


) 

47 


9 

57 


I 

73 


Y 

89 


i 

705 


y 

727 


1 





■ 





LF 

to 


SB 


* 

42 


■ 

58 


J 

74 


I 

90 


i 

706 


z 

722 


1 







1 




EC 

27 


+ 
43 


■ 

59 


K 

75 


[ 

91 


k 

707 


{ 

723 


1 


1 








FF 

72 


FS 
2a 


5 

44 


< 

60 


L 

76 


\ 

92 


I 

708 


I 

724 


I 


1 





; 


CR 

73 


GS 


45 


61 


M 

77 


] 
93 


m 

709 


} 

725 


1 


1 


■ 





SO 


RS 

JO 


■ 

46 


> 

62 


N 

78 


A 

94 


n 

110 


126 


' 


s 


1 




Si 

75 


us : / 


? 

63 




79 


~ 95 




777 


DT 
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4110 COMMAND REFERENCE 



ASCII CODE CHART 



Table A-3 
CHARACTERS USED IN iNT PARAMETERS 



BITS 


; ,■ 

a _ ■ , 

coftrrsot 


ncwwes 








1 


UPPERCASE 


LOWERCASE 


• 
.. 1 ( 


i'-S : ^.S:S'5 : :.iS:; : :iwsSv*s^^: 




@ 

64 


p 

80 


\ 

96 


P 

112 


lllffltll 
Fx'"""03" 


' 1 1 

'• 2 

#j 3 

|-- - ^ '- 

% " '5'"' 

) * 9 ^ 

* . : 

* ; 

i 

7" 7"? ■"" 


A 

65 


Q 

81 


a 

97 


q 

113 


B 

66 


R 

82 


b 

98 


r 

;i4 


c 

67 


s 

S3 


c 

99 


S 

115 


tsTmC 

Ak'sY^ 

ni "n 

BS ^CN '~ 


D 

68 


T 

84 


d 

100 


t 

116 


E 

69 


u 

85 


e 

101 


u 

777 


F 

70 


V 

86 


f 

702 


V 

118 


G 

7) 


w 

87 


g 

"J03 


w 

719 


H 

72 


X 

88 


h_ 


X 

720 


ISttil 
• 

i' ^ 

i ■ : 


HT ■ EM 
LF " SB~ ; 

"F? " FS ~ 


1 

73 


Y 

89 


i 

105 


y 

727 


J 

74 


z 

90 


j 

106 


z 

722 


K 

75 


[ 

97 


k 

107 


{ 

123 


L 

76 


\ 

92 


1 

108 


I 

724 


M 

77 


] 

93 


m 

109 


} 

725 


N 

78 


A 

94 


n 

110 


726 




79 


~~ 95 





DT 

727 



8 P.S'. 


! ■ 

CONTROL 


" — ~ — 

itflisiiiilii 

FIGURES 


t, — rp" ■-■ ' .' - 

j Ut>PERCA$C LOWERCASE 


- 


' 


SP 





t"*i fl'J /"v ?V? 


C j 5 ■ ' 


SH D1 


1 


1 


4 | Q a • q 


SX __ U2 
Tx ~ D3 _ 
ET''' D4_" 

~"bT Ib"'" 
"as _ 6 [ 




2 


3 t k b 

"' C S :"c " s~ 

S''. 'X> : S'l 'J:j 


# 


3 


3 1 '.? 

o i on 

« . .■ 

3 ... 11 

' l> 


$ 


4 


"J T .1 : 

" E f? " u j <r' >r_ 




5 


& 


6 


4 ■ 1 




7 


G W ! g f w 

11 iliij wM 


( ^ 


8 


H ' X ' t: • x 

ii is is? ii 


i e;s Jl HT EM 


) 


9 


t • a ) i ;. 


ir S3 


* 


: 


J Z i 2 

K i ' k " r 
■ L """ x '"'- ,-""■ - "' 

M t ! m } 

l-_ .... .'i , Wj -.ft 7-f 

' _ ; o ~W 


10 11 

t ! f/ C 

', 
i . 1 . 1 jB 
• 


CR"'" GS" 

so'; Ft 

jo; 

SI us 

^1 7 


+ 


) 


' 44 




- 


= 


■ 4 ! 






? 6 
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41 10 COMMAND REFERENCE 



A-3 



ASCII CODE CHARTS 



Table A-4 
CHARACTERS USED IN INT-REPORT AND INTC-REPORT PARAMETERS 



SBSSl 



8 8 1 
8,0 1 \'A 

i! 5 1 r 
e i ?! 

iitllllii 

I I'D: 

lllilil 

1 : 1 



■ ,i ■' 

i i . ■ 'si 



CONTROL 



FIGURES UPPERCASE LOWERCASE 



IB 

"sx" 
rx 
f-r 
Ft: 



01- 

HI 

03 

NF 



SP 



(a) 



2 B 

34 50| < 



P 

liiiil 



# 

i] 35 1 


3 

51 


c 

67 


s f 


i $ : 


4 

521 


D 

68: 


T ' 



AK SY 

ft * 

BL LJ 

IHilil 

HT ' FM 



5 

37' 53 69: 6 

& 6 F V 

38 54 70 E 

' 7 G H(V~ 



39 



( 8 H 



X 



IF 

~Vf" 

"m 

so" 

si" 



SB_ 
IC ' 

IK 

II 

: 

US 



9 MY 

57 731 

: J Z 



K 

59 75 : 



< L 

60 76: 



44 



M ] 

45; _ ei 77: 

* > N 

46: 52 78L 



? 

63| 79| 



;*£;: 




s 


•j 




"T 


e 




t) 


Hi 


l^p 


V 


- 




V. 




-" 




h 




X 


SSM 




y 


.:SfJ; 




:■ 




i. 




" 


jip 


III; 


ff/lf 


Sii:: 


1 


m 


SS- 


} 


itM 




•-^ 







F'T 
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8 M ' ~ 

CONTROL 


ilHlllilJlltlpS 

FIOURCS 


'0 ; " "' 1 i 

UPPERCASE 


" - 

LOWERCASE 


.•> 1 


NU DL 


SP 


■ 


P 

TTXT 

llslsliif 

miiit 

liBii 


^7T~ 

b r : 
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C S- 
d : t * 

i- J 
■ 

- 

i * 

- 


SH | D1 


1 


1 




? 


liiilfi 

Pliliitll 
Slliftll 
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EX 03 


# 


3 


ET 04 
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AK SY 

"wT 1 at" 

8S r CN 

H~r "em ~ 


$ 
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"> 


E U i 
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K """ t""~ 
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n 1 . ; 

~0~1 _ ' 

7.1 ,:l 
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7 
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8 


J 
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LF SB 

VT EC 
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IT THT 
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1 1 
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41 10 COMMAND REFERENCE 



ASCII CODE CHART 



Table A-5 
CHARACTERS USED IN XY PARAMETERS 



S'B 
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h x 
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A-5 



ASCII CODE CHARTS 



Table A-6 
CHARACTERS USED IN XY-REPORT PARAMETERS 
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41 10 COMMAND REFERENCE 



Appendix B 



INT PARAMETERS 



This appendix describes how to manually construct int 
parameters. Note that the sign information for an int repre- 
sentation is contained in the final character, and therefore, 
the final character is treated differently. 

The 4110 Series Host Programmers Manual contains a list of 
already packed int parameters from -2047 to 2047 in 
Appendix B. If you want an int parameter in that range 
quickly, see that manual and appendix. 

The algorithm is: 

1 . Check If the integer value is present In the Tables B-1 to 
B-6, If it is, the int characters are next to it, and you are 
done. If not, go to Step 2. 

2. Let NUMBER be the absolute value of your number. 

3. Until NUMBER is less than 1 6, repeat these steps: 

a. Find the largest integer that is less than NUMBER 
in the Tables B-1 to B-6. 

b. List the int representation of this "largest integer" 
(directly below any previous representation if this 
is not the first iteration). 

c. Subtract the integer in the table from NUMBER 
and put the result in NUMBER. 

4. If the original number is positive, take the last character 
for your int from the left half of the Table B-1 . If the 
original number is negative, use the right half of Table 
B-1 . Put this int into the list of int representations. 

5. Add (symbolically) the list of int representations using 
the two following definitions: 

• @ is equivalent to in non-right-most positions. 

• is equivalent to in the right-most position. 

See the following Examples to clarify the use of the 
algorithm. 



EXAMPLES 

Positive Number Suppose you want to convert the number 
20491 to int f^r™' 5 * 

1 . Does 20491 appear in the the tables? No 

2. NUMBER = 20491 

3 NUMBFR - Nnmhpr In Tahlo WTRonroeonlotinn 

20491 - 20480 T@0 

11 



T@; 

Negative integer Suppose you want to convert the number 
-1331 20 to int format. 

1. Does -1331 20 appear in the the tables? No 

2. NUMBER = 133120 



3. NUMBER - Number In Table 
133120 - 131072 
2048 - 2048 




INT Representation 

B@ @0 
B@0 



BB< 



41 1 SERIES COMMAND REFERENCE 



B-1 



INT PARAMETERS 



Table B-1 
ONE CHARACTER /NTS 



Table B-2 
TWO CHARACTER INTS 



Integer 


In! 


Value 


Representation 








1 


1 


2 


2 


3 


3 


4 


4 


5 


5 


6 


6 


7 


7 


8 


8 


9 


9 


10 




11 


; 


12 


> 


13 


= 


14 


> 


15 


? 



Integer 


Int 


Value 


Representation 


-0 


s p 


-1 


I 


-2 


■■ 


-3 


# 


-4 


$ 


-5 


% 


-6 


& 


-7 


' 


-8 


( 


-9 


) 


-10 




-11 


+ 


-12 


, 


-13 


- 


-14 




-15 


/ 



Integer 


Int 


Value 


Representation 


16 


A0 


32 


B0 


48 


CO 


64 


DO 


80 


EO 


96 


FO 


112 


GO 


128 


HO 


144 


10 


160 


JO 


176 


KG 


192 


LO 


208 


MO 


224 


NO 


240 


00 


256 


PO 


272 


QO 


288 


RO 


304 


SO 


320 


TO 


336 


UO 


352 


VO 


368 


WO 


384 


XO 


400 


YO 


416 


ZO 


432 


[0 


448 


\0 


464 


]0 


480 


a0 


496 





512 


'0 



Integer 


Int 


Value 


Representation 


528 


aO 


544 


bO 


560 


cO 


576 


dO 


592 


eO 


608 


to 


624 


go 


640 


hO 


656 


iO 
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41 10 SERIES COMMAND REFERENCE 



INT PARAMETERS 



Table B-3 
THREE CHARACTER INTS 



Table B-4 
FOUR CHARACTER ,'W7B 



Integer 


Int 


Value 


Representation 


1024 


A@0 


2048 


B@0 


3072 


C@0 


4096 


D@0 


5120 


E@0 


6144 


F@0 


7168 


G@0 


8192 


H@0 


9216 


l@0 


10240 


J@0 


11264 


K@0 


12288 


L@0 


13312 


M@0 


14336 


N@0 


15360 


O@0 


16384 


P@0 


17408 


Q@0 


18432 


R@0 


19456 


s@o 


20480 


T@0 


21504 


u@o 


22528 


v@o 


23552 


w@o 



25600 


Y@0 


26624 


2@0 


27648 


[@o 


28672 


\@0 


29696 


]@0 


30720 


A@0 


31744 


_@0 


32768 


'@0 



Integer 


Int 


Value 


Representation 


33792 


a@0 


34816 


b@0 


35840 


c@0 


36864 


d@0 


37888 


e@0 


38912 


f@0 


39936 


g@o 


40960 


h@0 


41984 


i@0 


43008 


j@0 


44032 


k@0 


45056 


l@0 


46080 


m@0 


47104 


n@0 


48128 


o@0 


49152 


p@0 


50176 


q@0 


51200 


r@0 


52224 


s@0 


53248 


t@0 


54272 


u@0 


55296 


v@0 


56320 


w@0 


57344 


x@0 


58368 


y@0 


59392 


z@0 


60416 


{@0 


61440 


I 


62464 


}@o 


63488 


~@0 


64512 


D L@0 



Integer 


Int 


Value 


Representation 


65536 


A@@0 


131072 


B@@0 


196608 


C@@0 


262144 


D@@0 


327680 


E@@0 


393216 


F@@0 


458752 


G@@0 


524288 


H@@0 


589824 


l@@0 


655360 


J@@0 


720896 


K@@0 


786432 


L@@0 


851968 


M@@0 


917504 


N®@0 


983040 


O@@0 


1048576 


P@@0 


1114112 


Q@@0 


1179648 


R@@0 


1245184 


S@@0 


1310720 


T@@0 


1376256 


U@@0 


1441792 


V@@0 


1507328 


W@@0 


1572864 


X@@0 


1638400 


Y@@0 


1703936 


Z@@0 


1769472 


[@@0 


1835008 


\@@0 


1900544 


]@@0 


1966080 


A@@0 


2031616 


„@@0 


2097152 


'©©0 



Integer 


Int 


Value 


Representation 


2162688 


a@@0 


2228224 


b@@0 


2293760 


c@@0 


2359296 


d@@0 


2424832 


e@@0 


2490368 


f@@0 


2555904 


g@@o 


2621440 


h@@0 


2686976 


i@@0 


2752512 


i@@o 


2818048 


k@@0 


2883584 


l@@0 


2949120 


m@@0 


3014656 


n@@0 


3080192 


o@@0 


3145728 


p@@0 


3211264 


q@@0 


3276800 


r@@0 


3342336 


s@@0 


3407872 


t@@0 


3473408 


u@@0 


3538944 


v@@0 


3604480 


w@@0 


3670016 


x@@0 


3735552 


y@@o 


3801088 


z@@0 


3866624 


{@@0 


3932160 


|@@0 


3997696 


}@@0 


4063232 


~@@0 


4128768 


D L@@0 
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Table B-5 
FIVE CHARACTER INTS 



Table B-6 
SIX CHARACTER INTS 



Integer 


Int 


Value 


Representation 


4194304 


A@@@0 


8388608 


B@@@0 


12582912 


C@@@0 


16777216 


D@@@0 


20971520 


E@@@0 


25165824 


F@@@0 


29360128 


G@@@0 


33554432 


H@@@0 


37748736 


l@@@0 


41943040 


J@@@0 


46137344 


K@@@0 


50331648 


L@@@0 


54525952 


M@@@0 


58720256 


N@@@0 


62914560 


0@@@0 


67108864 


P@@@0 


71303168 


Q@@@0 


75497472 


R@@@0 


79691776 


S@@@0 


83886080 


T@@@0 


88080384 


u@@@o 


92274688 


v@@@o 


96468992 


w@@@o 


100663296 


x@@@o 


104857600 


Y@@@0 


109051904 


z@@@o 


113246208 


[@@@0 


117440512 


\@@@0 


121634816 


]@@@0 


125829120 


A@@@0 


130023424 


_@@@0 


134217728 


'@@@0 



Integer 


Int 


Value 


Representation 


138412032 


a@@@0 


142606336 


b@@@0 


1 46800640 


c@@@0 


1 50994944 


d@@@0 


155189248 


e@@@0 


159383552 


f@@@0 


163577856 


g@@@0 


167772160 


h@@@0 


171966464 


i@@@0 


176160768 


j@@@0 


180355072 


k@@@0 


184549376 


l@@@0 


188743680 


m@@@0 


192937984 


n@@@0 


197132288 


o@@@0 


201326592 


p@@@0 


205520896 


q@@@0 


209715200 


r@@@0 


213909504 


s@@@0 


218103808 


t@@@0 


222298112 


u@@@0 


226492416 


v@@@0 


230686720 


w@@@0 


234881024 


x@@@0 


239075328 


y@@@0 


243269632 


z@@@0 


247463936 


{@@@0 


251658240 


!@@@o 


255852544 


}@@@0 


260046848 


~@@@0 


264241 1 52 


D L@@@0 



Integer 


Int 


Value 


Representation 


268435456 


A@@@@0 


536870912 


B@@@@0 


805306368 


C@@@@0 


1073741824 


D@@@@0 


1342177280 


E@@@@0 


1610612736 


F@@@@0 


1879048192 


G@@@@0 


2147483648 


H@@@@0 


2415919104 


l@@@@0 


2684354560 


J@@@@0 


2952790016 


K@@@@0 


3221 225472 


L@@@@0 


3489660928 


M@@@(S0 


3758096384 


N@@@@0 


4026531840 


O@@@@0 
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ERROR CODES 



INTRODUCTION 

Each error condition which a 41 1 Series terminal can 
detect has an error code and a severity level. 

When the terminal detects an error condition, it stores the 
error code and severity level in a limited-size queue for later 
retrieval by a REPORT-ERRORS commmand from the host. 

If the error's severity level is greater than or equal to the 
current error threshold, then the terminal displays a mes- 
sage for the operator. When the terminal is powered up or 
reset, its error threshold is set to 2, so that the only errors 
displayed are those with a severity ievei of 2 or more. The 
error threshold can be changed with the SET-ERROR- 
THRESHOLD command from the host or the 
ERRORLEVEL setup command from the keyboard. 

Since the terminal has two command sets, TEK commands 
and ANSI commands, the error codes for the two sets are 
listed separately. TEK error codes begin with two alphanu- 
meric characters (usually alpha), while ANSI error codes 
begin with either a bracket ([) and a character, or a character 
and a space. Other than this difference, errors from the two 
command sets are treated similarly. 



SEVERITY LEVELS 

There are four severity levels, numbered from zero to three: 

• Level 0. Errors of severity level zero are hardly errors at 
all. The associated message begins with the words "Ter- 
minal issues message...". Typically, these errors occur 
for commands which are not installed. For instance, 
when 4112 commands are sent to a 41 1 4, the terminal 
detects level zero errors. 

• Level 1 . Level one errors are "warnings." The corres- 

^j<ji iuii iy ii icooa^jco t^^yn i »*i«.i • mw ■* w> i_«w iw ■-*■ 

issues warning ...". Typically these occur when the com- 
mand is inappropriate: deleting a segment that does not 
exist, for example. 

• Level 2. Level two errors result from invalid commands. 
For instance, a command's parameter may be outside 
the specified range. The corresponding message begins 
with the words "Terminal detects error ...". 

• Level 3. Level three errors occur when the command is 
valid, but for some reason the terminal cannot execute 
the command. (For instance, there may be insufficient 
memory to hold all the information being included in a 
segment definition.) For these errors, the message starts 
with the word, "Terminal system error...". 
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ERROR CODES 

The error codes are each composed according to the follow- 
ing scheme: 

• Each error code consists of four characters. 

• In most error codes, the first two characters are the op 
code for the command which causes the error. For 
instance, error IA1 1 is associated with the SET-PICK- 
APERTURE command. 

Some errors, however, are associated with no particular 
command. For these errors, the first two characters are a 
letter and a digit. For instance, error 101 1 (invalid device- 
function code) can occur with many graphic input com- 
mands. Again, error J 109 (disk hardware initialization 
error) can occur only when the terminal is turned on 
before any commands have been sent to it. 

• The third character in an error code is a digit. Digits from 
1 to 9 name the parameter with which the error is associ- 
ated. Digit indicates that the error is associated with 
the command as a whole: the op code itself is regarded 
as the "zeroeth parameter." Commands that detect 
errors in parameters 10 and above use the digit 9. 

• The fourth character in an error code is also a digit. The 
most frequently used digits here are 0, 1 , 2, 3 and 9: 

Indicates an "existence problem." The object referred 
to does not exist when it ought to exist, or does exist 
when it ought not to exist. 

1 Indicates an "invalid value." 

2 Indicates an "out of memory problem." 

3 A "context error." The command is valid, but cannot 
be executed at this time. (For instance, trying to end a 
segment when no segment is currently being 
defined.) 

9 A hardware error prevents or halts execution. (For 
example, the door is open on a disk drive when you 
try to copy from it.) 



For example, consider the "SO10" error code. Here, "SO" 
means the BEGIN-SEGMENT command, which has the 
syntax E cSO int. The "1 " refers to the first (and only) param- 
eter of that command, which is the segment number. The 
"0" indicates an "existence problem;" the segment 
referred to already exists. 

Commands Not Installed in the Terminal 

Op codes beginning with letters from I to Z may occur in 
present or future 41 1 Series terminals. When the terminal 
receives one of these escape-sequence commands and 
does not recognize that command, it detects an error of 
severity level zero. After detecting the error, the terminal 
then ignores all subsequent characters until it receives an 
E c, c s, c s, or u s character, (it does this so as to skip over any 
parameters for the unrecognized command.) 

For instance, suppose the terminal does not have Option 01 
installed, and the host sends it the following character 
sequence: 

E cOD0 E cKA1 

Since Option 01 is not installed, the terminal does not rec- 
ognize the SET-DUPLEX-MODE: command, E cOD0. On 
receiving the E cOD op code, it detects a type OD00 error 
(and displays the OD00 error message if the error threshold 
is set to zero). It ignores the following character, 0. On 
receiving the following E c, it resumes processing of the 
characters received, so that it correctly interprets and exe- 
cutes the ENABLE-DIALOG-AREA: 1 command, E cKA1. 

If your host program sends commands that may not be 
installed in all 41 1 Series terminals, then these commands 
should be followed by other commands which are recog- 
nized by all terminals in the series. For instance, after issu- 
ing commands to change raster terminal (4112,4113,4115) 
only settings, the host could send a u s character (the 
ENTER-ALPHA-MODE command) before sending any 
alphatext to the terminal. That way, if the program is also 
sent to a 41 1 4 or 41 1 6 terminal, the u s character causes the 
terminal to resume normal processing of the characters it 
receives. 
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DISK AND 3PPI HARDWARE ERRORS 

For some disk system (Option 42, 43, or 45) or Three Port 
Peripheral Interface (Option 10) errors, the error message 
reports a "hardware error number." Table C-1 lists the disk 
and 3PPI hardware errors: 



Disk System Context trrors 

For some file system errors, a supplemental error message 
may be displayed. This supplemental message describes 
the type of error which has occurred. Table C-2 explains 
these context error messages: 



Table C-1 
DISK AND 3PPI HARDWARE ERRORS 



Table C-2 
DISK SYSTEM CONTEXT ERRORS 



Error 




Number 


Explanation 


1 


Disk: Cannot complete result phase. 


2 


Disk: Cannot sense drive status. 


3 


Disk: Cannot sense interrupt status. 


4 


Disk: RQM wrong state. 


5 


Disk: (Reserved.) 


6 


Disk: (Reserved.) 


7 


Disk: Invalid command. 


8 


Disk: Bad track. 


9 


Disk: Control mark. 


10 


Disk: CRC (cyclic redundancy check) error. 


11 


Disk: Missing address data. 


12 


Disk: Missing address mark. 


13 


Disk: No data. 


14 


Disk: Wrong cylinder. 


15 


Disk: Overrun. 


16 


Disk: (Reserved.) 


17 


Disk: Not two-sided. 


18 


Disk: Failed command phase (bytes not output). 


33 


3PPI: Circular buffer overrun. 


34 


3PPI: 8250 data overrun. 


35 


3PPI: Errors 33 and 34. 


36 


3PPI: 8250 parity error. 


37 


3PPI: Errors 33 and 36. 


38 


jkki: trrors cm ana jo. 


39 


3PPI: Errors 33, 34, and 36. 


40 


3PPI: 8250 framing error. 


41 


3PPI: Errors 33 and 40. 


42 


3PPI: Errors 34 and 40. 


43 


3PPI: Errors 33, 34, and 40. 


44 


3PPI: Errors 36 and 40. 


45 


3PPI: Errors 33, 36, and 40. 


46 


3PPI: Errors 34, 36, and 40. 


47 


3PPI: Errors 33, 34, 36, and 40. 



Error 


Explanation 




the specified disk. 


Drive Not Ready 


There is no disk in the specified drive, or 
the door is open. 


Write Protected 


The disk to which you are trying to write 
can only be read at this time. 


Invalid Device Specifier 


The device you specified is not valid for 
this command. 


File Not Found 


The terminal cannot find the specified 
file on the specified device. 


Directory Full 


The disk already contains the maximum 
number of files permitted. 


File Full 


There is no more room to write data in 
the specified file. 


File Currently Being 
Written 


Trying to access a file that is currently 
being written to. 


Invalid Media Format 


The disk in the specified device is 
formatted with an unsupported format. 


Device Busy 


The specified device is currently active 
and therefore cannot be accessed. 


Invalid File Specifier 


You specified a device and filename 
when only a filename is valid. 


File Busy 


Trying to protect or rename a file that is 
currently being written to or read. 


File Already Exists 


You are trying to rename a file to a name 
that already exists. 
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DMA Transfer Errors 

DM: Device Errors. When DM: is specified as a device, 
there are error messages that may be reported if certain 
errors are generated (instead of the standard "Terminal 
detects..."). These error messages are: 



"DMA Option 3A 
failed to power up' 



"Invalid DMA 
Parameter" 



There is not enough memory availa- 
ble to satisfy the requirements for 
DM: use. 

The parameter portion of the 
DM:parameter device is invalid. 



Also, for some file system errors ("type 9" errors such as 
JC09, JC39, JD39, etc.), a supplemental error message is 
displayed when an error is generated by a transfer involving 
the DMA. This supplemental message describes the type of 
error which has occurred. Table C-3 lists these errors: 



Pseudo Devices. When the DMA pseudo devices are speci- 
fied as devices, there are error messages that may be 
reported if certain errors are generated (instead of the 
standard "Terminal detects..."). These error messages are: 

"DMA Option 3A There is not enough memory availa- 

Pseudo Devices failed ble to satisfy the requirements for 
to power up" DMA pseudo device use. 



"Invalid Pseudo 
Device Parameter" 

"Data Format Error" 



The parameter portion of the 
pseudo device specifier is invalid. 

There is an error in the data 
received from the host computer by 
a DS: or SG: pseudo device. 



Table C-3 
DMA TRANSFER ERRORS 



Error 


Explanation 


Host not ready for DMA 
transfer 


The host computer is not ready to start a 
DMA transfer (as indicated by the 
READY line of the DR1 1 B board). 


Host aborted DMA 
transfer 


The host computer has sent an ABORT 
code to the terminal (via the FNCT 
lines). 


DMA transfer failed 


The host computer tried to transfer more 
data in a block than was specified in the 
last SET-DMA-BLOCK-SIZE command 
OR the host tried to initiate a block 
transfer before the end of the last 
terminal-to-host DMA block transfer. 


Host termination signal 
invalid 


The signals sent by the host at the end 
of a DMA block transfer are invalid. 
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TEK ERROR CODES 



°/o! 



SELECT-CODE = E c%! int 



%!00 (Level 0): Unrecognized command; terminal firm- 
ware is Version 3. 

%!1 1 (Level 2): Invalid command-set (must be or 1 .) 



10 



IA 



(For several GIN commands.) 



I002 (Level 2): Insufficient memory available for GIN 

functions. (Only detected at power-up or 
during a RESET.) 

101 1 (Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 



11 ENABLE-4953-TABLET-GIN 

DISABLE-4953-TABLET-GIN 



E c! char 



1100 (Level 0): Unrecognized command (Option 13 or 14 
not installed). 



SET-PICK-APERTURE = 6 clA int 



IA1 1 (Level 2): Invalid aperture-width (must range from 
to 4095). 

IC SET-GIN-CURSOR = E clC int int 

1011 (Level 2): Invalid device-function code. (Seethe 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 

IC1 3 (Level 2): Graphic input has already been enabled 
for the specified device-function code. 

IC20 (Level 2): Segment does not exist, or is currently 
being defined. 

IC21 (Level 2): Invalid segment-number (must range from 
to 32767). 

ID DISABLE-GIN = E clD int 

101 1 (Level 2): Invalid device-function code. 



IE ENABLE-GIN = E clE int int 

1011 (Level 2): Invalid device-function code. 

IE00 (Level 2): The cursor segment for the specified 
device-function code does not exist. (It 
has been deleted after the SET-GIN- 
CURSOR command which assigned it to 
that device-function code.) 

IE03 (Level 2): Command is invalid at this time. (The 

segment being used as the cursor for the 
specified device-function code is a seg- 

1 1 ic?i il wi hoi i io oui i oi my ucii ly uom iou.j 

IE1 (Level 2): The specified GIN device is not installed 
in the terminal. 

IE13 (Level 2): The specified GIN device is already 
enabled. 

IE21 (Level 2): Invalid number-of-GIN-events. (Must 
range from to 65535.) 

IF SET-GIN-STROKE-FILTERING = E clF int int int 

101 1 (Level 2): Invalid device-function code. (See the 

table with the ENABLE-GIN command for 
valid device-function codes.) 

IF00 (Level 0): Unrecognized command. (The tablet 
option is not installed.) 

IF10 (Level 2): Stroke filtering is not valid for the speci- 
fied device-function code. (Only allowed 
for stroke function.) 

IF21 (Level 2): Invalid distance-filter (range is to 
32767). 

IF31 (Level 2): Invalid time-filter (range is to 32767). 



IG 



SET-GIN-GRIDDING = E clG int int int 



101 1 (Level 2): Invalid device-function code. (See the 

table with the ENABLE-GIN command for 
valid device-function codes.) 

IG10 (Level 2): Gridding does not apply to the specified 
device-function code. (Gridding is not 
allowed for the stroke function.) 

IG21 (Level 2): Invalid x-grid-spacing (41 1 2, 41 1 3, 41 1 4, 
41 16: to 4095; 41 15: -2 31 to 2 31 -1). 

IG31 (Level 2): Invalid y-grid-spacing (41 12,411 3, 41 1 4, 
41 16: to 4095; 41 15: -2 31 to 2 31 -1). 
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IH 



SET-TABLET-HEADER-CHARACTERS = E clH int 



IHOO (Level 0): Unrecognized command. (Tablet option is 
not installed.) 

IH11 (Level 2): Invalid character-set-selector. (Must be 
or 1 ; in Setup mode, must be CONTROL 
or LETTERS.) 

II SET-GIN-INKING = E cll int int 

1011 (Level 2): Invalid device-function code. (Seethe 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 

n iu V-v v ~" ^-y- it i(\ii iy uubo nui cippiy lu Li ib oucon icu 

device-function code. (Inking is not 
allowed for the pick function.) 

1121 (Level 2): Invalid inking mode (must be 0, 1 or 2). 



IL 



SET-REPORT-MAX-LINE-LENGTH = e clL int 



IL1 1 (Level 2): Invalid max-line-length. (Must range from 
to 65535.) 



IM 



SET-REPORT-EOM-FREQUENCY = E clM int 



IM 1 1 (Level 2): Invalid EOM-frequency setting (must be 
or1). 



IN 



SET-TABLET-SIZE = E clN int 



IN00 (Level 2): Unrecognized command. (Requires ver- 
sion 2 or later of Option 1 3 or 1 4 firm- 
ware.) 

IN1 1 (Level 2): Invalid tablet-size-mode. (Must be 0, 1 , 
or 2.) 

IP REPORT-GIN-POINT = E clP int 

101 1 (Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a list of valid device-function 
codes.) 

IE10 (Level 2): The specified GIN device is not installed 
in the terminal. 

IE13 (Level 2): A plotter device is not assigned to the 
specified port. 

IP1 3 (Level 2): The device-function code names a device 
which has already been enabled for a 
different graphic input function. 



IQ REPORT-TERMINAL-SETTINGS = E clQ char char 

No errors are detected for this command. 



IR 



SET-GIN-RUBBERBANDING = E clR int int 



101 1 (Level 2): Invalid device-function code. (See the 
ENABLE-GIN command for a table of 
device-function codes.) 

IR10 (Level 2): Rubberbanding does not apply to the 

specified device-function code. (Rubber- 
banding is only allowed for the locator 
function. It is not allowed for the pick and 
stroke functions.) 

1R21 (Level 2). Invalid rubberbanding mode (must be 0, 
1,or2). 



IS 



SET-REPORT-SIG-CHARS = E clS int int int 



101 1 (Level 2): Invalid report-type-code. (Must be a valid 
device-function code, or from -1 to -3.) 

IS21 (Level 2): Invalid sig-char. (Must range from to 
127). 

IS31 (Level 2): Invalid term-sig-char. (Must range from 
to 127.) 



IT 



SET-TABLET-STATUS-STRAP = E clT int 



IT00 (Level 0): Unrecognized command. (The tablet 
option is not installed.) 

IT11 (Level 2): Invalid strap-setting (must be or 1). 



IV SET-GIN-AREA = E clV int int xy xy 

101 1 (Level 2): Invalid device-function (see ENABLE- 
GIN). 

IV00 (Level 0): Unrecognized command; terminal firm- 
ware is Version 3 or earlier. 

IV03 (Level 3): Out of memory while processing com- 
mand. 

IV21 (Level 2): Invalid window-specifier (range is -1 to 
64). 

IV31 (Level 2): lnvalid./?rs?-corHer(XorYoutof range 
to 4095). 

IV41 (Level 2): Invalid second-corner (X or Y out of range 
to 4095, or area is of zero width or 
height). 
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IW 



SET-GIN-WINDOW = E clW xy xy 



IWOO (Level 0): Unrecognized command; terminal firm- 
ware is Version 3 or earlier. 

IW1 1 (Level 2): \nvaM first-corner (X or Y out of range 
-2 31 to2 31 -1). 

IW21 (Level 2): Invalid second-corner (X or Y out of range 
-2 31 to2 31 -1). 



IX 



SET-GIN-DISPLAY-START-POINT = E clXintxy 



\\J I I ^LCVCI C). II IVailU UC fltC-j (ft^tcisrt ^ui ui i iwiwi. yvvv 

ENABLE-GIN for a table of valid device- 
function codes.) 

IX00 (Level 0): Invalid command; firmware is Version 3 or 
earlier. 

iy\^ I yl-O V Cl C-f. II I VCtll«_l JIW* t=^«^tl*t \*T 1 1 s_, ^ I i W, if i i i , 

4116:X = to 4095, Y = to 4095; 
41 1 5: X = -2 31 to 2 31 -1 , Y = -2 31 to 
2 31 -1). 

JO and J1 : Disk System Errors on Power-Up 

J002 (Level 3): Memory error detected by standard firm- 
ware. 

J102 (Level 3): Memory error detected by optional 
peripheral firmware. 

J109 (Level 3): Hardware initialization error in option 
controller board. 



JB ACTIVATE-LPOS = E cJB 

JB00 (Level 0): Unrecognized command (Option 
42/43/45 or Version 6 or higher not 
installed). 

JB03 (Level 2): A filename was specified when LPOS was 
resident in terminal memory, or a filename 
was not specified, but LPOS was active. 

JB1 (Level 2): The boot-file was not found. 

JB11 (Level 2): Illegal filename. 

JB12 (Level 3): Out of memory while performing com- 
mand. 

JB13 (Level 2): Context error (local programmability 
already active). 

JB1 9 (Level 2): Disk hardware error (drive not ready, I/O 
error). 



JC 


COPY = 


JC01 


(Level 2) 


JC02 


(Level 3) 


JC03 


(Level 2) 


JC10 


(Level 2) 


JC11 


(Level 2) 


JC12 


(Level 3) 


JC13 


(Level 2) 


JC19 


(Level 2) 


JC20 


(Level 2) 


JC21 


(Level 2) 


JC22 


(Level 3) 


JC30 


(Level 2)- 


JC31 


(Level 2)- 


JC32 


(Level 3): 



JC33 (Level 2; 



JC39 (Level 2; 



E cJC device string device 

Data format error (Options 3A and 9 only). 

: Out of memory while attempting DMA 
transfer (Option 3A only). 

: Attempt to copy an entire disk volume 
onto itself (e.g., a copy from F0: to F0:). 

: Specif ied source device is not installed, or 
file does not exist. 

Invalid source specifier. 

Out of memory while parsing the parame- 
ter, or while executing the command. 

Parameter 1 context error (not an input 
device, or device js busy). 

: Disk hardware error or drive not ready on 
the source device, or error in DMA block 
transfer. 

: Separator parameter missing. 

: Invalid separator (must be empty string or 
TO; in Setup mode, must be TO). 

Out of memory while parsing the 
parameter. 

Specified destination device is not 
installed. 

Invalid destination specifier. 

Out of memory while parsing the parame- 
ter, or while executing the command. 

Parameter 3 context error. (Invalid desti- 
nation device, device is busy or full, or 
existing disk file is write protected.) 

Disk hardware error or drive not ready on 
the destination device, or error in DMA 
block transfer. 
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JD DIRECTORY = E cJD device string device 

JDOO (Level 2): Unrecognized command. (Disk drive 
option is not installed.) 

JD10 (Level 2): The specified source device is not 
installed or file does not exist. 

JD11 (Level 2): Invalid source specifier. 

JD12 (Level 3): Out of memory while parsing the parame- 
ter, or while executing the command. 

JD13 (Level 2): Context error in parameter 1 . (The speci- 
fied device is not a disk drive, or failed 
reading bit map.) 

JD19 (Level 2): Disk hardware error (or drive not ready) 
for the disk drive whose directory is being 
requested. 

JD20 (Level 2): Separator parameter missing. 

JD21 (Level 2): Invalid separator (must be empty string or 
TO). 

JD22 (Level 3): Out of memory while parsing the parame- 
ter. 

JD30 (Level 2): The specified destination device is not 
installed. 

JD31 (Level 2): Invalid destination specifier. 

JD32 (Level 3): Out of memory while parsing the parame- 
ter, or while executing the command. 

JD33 (Level 2): Parameter 3 context error. (The device 

specified is not a valid destination device, 
the disk is full, or the file is write- 
protected.) 

JD39 (Level 2): Hardware error for the destination device. 
(I/O error, write-protect error, disk drive 
not ready, or DMA block transfer error.) 



JE STOP-SPOOLING = E cJE 

No errors are detected for this command. 

JF FORMAT-VOLUME = E cJF device 

JFOO (Level 2): Unrecognized command. (Disk drive 
option not installed.) 

JF10 (Level 2): Device is not installed. 

JF1 1 (Level 2): Invalid device specifier. 

JF12 (Level 3): Out of memory while parsing the parame- 
ter. 

JF13 (Level 2): The device specified is not a disk drive, is 
write-protected, is ousy, detects a verity 
error, detects a bit map error, or is not 
mounted. 

JF1 9 (Level 2): Hardware error at the specified disk drive. 
(Format error, drive not ready, or write- 
protect switch or notch error.) 

JH SET-DMA-BLOCK-SIZE = E cJH int 

JHOO (Level 0): Unrecognized command (Option 3A is not 
installed.) 

JH03 (Level 2): Command received after DMA failed to 
power up. 

JH1 1 (Level 2): Invalid parameter (must be from 1 to 
65504). 



JJ 



DISMOUNT = E cJJ device 



JJ00 (Level 0): Unrecognized command; firmware is 
Version 3 or earlier, or there are no disk 
options installed. 



JJ10 (Level 2) 
JJ11 (Level 2) 
JJ13 (Level 2) 



The device is not installed. 

Invalid device parameter. 

Parameter 1 context error (not a valid 
device, or device is busy). 
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JK DELETE-FILE = E cJK device 

JKOO (Level 2): Unrecognized command. (Disk drive 
option is not installed.) 

J K1 (Level 2): The specified file does not exist or device 
is not installed. 

JK11 (Level 2): Invalid file-specifier. 

JK12 (Level 3): Out of memory while parsing parameter. 

JK13 (Level 2): The specified device is not a disk drive, is 
write-protected, is busy, or detects a bit 
map error. 

JK19 (Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 

JL LOAD = E cJL device 

JL02 (Level 3): Out of memory while performing LOAD 
command. 

JL03 (Level 2): Nesting error. (LOAD commands are 
nested too deeply.) 

JL10 (Level 2): File or device does not exist. 

JL11 (Level 2): Invalid source specifier. 

JL12 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

J L1 3 (Level 2): Context error in parameter 1 . (Not a valid 
source device, device is busy, or com- 
mand detects a disk format error.) 

JL1 9 (Level 2): Device hardware error (disk hardware 

«-..«- «I>;.ia «*vf vr**yA\i r\r HMA \r\\r\r*ir Ironc. 
tJIIUI, UIIV? IIUI I cdujr, \j\ t^iMirS wivwn n «• iw 

fer error). 

JP PROTECT-FILE = E cJP device int 

JPOO (Level 2): Unrecognized command. (Disk drive 
option is not installed.) 

JP1 (Level 2): The specified file or disk drive does not 
exist. 

JP11 (Level 2): Invalid file specifier. 

JP12 (Level 3): Out of memory while parsing parameter. 

JP13 (Level 2): Either the specified device is not a disk 

drive, or the file (or entire diskette volume) 
has been write-protected. 

JP1 9 (Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 

JP21 (Level 2): Invalid write-protect-mode (must be 
0or1). 



JQ REPORT-DEVICE-STATUS = E cJQ device 

Device is not installed. 

Invalid device specifier. 

Out of memory while parsing parameter. 

-FILE = E cJR device string device 

Unrecognized command. (Disk drive 
option is not installed.) 

The specified device or file does not exist. 

Invalid old-filename specifier. 

Out of memory while parsing parameter. 

Parameter 1 context error (file is write- 
protected, device is busy, or command 

UCIOOIO II ivdliu Uiorv ivimGi/. 

JR1 9 (Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 



JQ10 


(Level 2): 


JQ11 


(Level 2): 


JQ12 


(Level 3): 


JR 


RENAME 


JROO 


(Level 2): 


JR10 


(Level 2): 


JR11 


(Level 2): 


JR12 


(Level 3): 


JR13 


(Level 2): 



JR20 
JR21 

JR22 
JR30 



JR31 
JR32 
JR33 

JR39 



(Level 2): 
(Level 2): 

(Level 3): 
(Level 2): 



(Level 2) 






(Level 2) 
(Level 2) 



Separator parameter is missing. 

Invalid separator (must be empty string or 
TO). 

Out of memory while parsing parameter. 

Either the device specified in parameter 3 
does not exist, or is different from the 
device specified in parameter 1 , or new- 
filename already exists. 

Invalid new-filename specifier. 

Out of memory while n arsing parameter. 

Parameter 3 context error (invalid device 
specifier). 

Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 
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JS SPOOL = E cJS device string device 

JS01 (Level 2): Data format error (Options 3A and 9 only). 

JS02 (Level 3): Out of memory while attempting DMA 
transfer (Option 3A only). 

JS03 (Level 2): Command context error. (A spooling 
operation is already in progress.) 

Specified source does not exist. 

Invalid source specifier. 

Out of memory while parsing parameter, 
or while executing the command. 

Parameter 1 context error. (Not a valid 
source uGVice, cr device \s busy.) 

Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 

Separator parameter is missing. 

Invalid separator (must be empty string or 
TO). 

Out of memory while parsing parameter. 

Specified destination does not exist. 

Invalid destination device specifier. 

Out of memory while parsing parameter, 
or while executing the command. 

JS33 (Level 2): Parameter 3 context error. (Not a valid 

destination, device is busy, or existing file 
is write protected or open.) 

JS39 (Level 2): Device hardware error (disk hardware 

error, drive not ready, or DMA block trans- 
fer error). 



JS10 


(Level 2): 


JS11 


(Level 2): 


JS12 


(Level 3): 


JS13 


(Level 2): 


JS19 


(Level 2): 


JS20 


(Level 2): 


JS21 


(Level 2): 


JS22 


(Level 3): 


JS30 


(Level 2): 


JS31 


(Level 1): 


JS32 


(Level 3): 



JU SET-USER-NUMBER = E cJU int 

JUOO (Level 0): Unrecognized command (firmware is 
Version 3 or earlier or disk option is not 
installed). 

JU11 (Level 2): Invalid user-number (must be to 15). 



JV 

JV02 

JV01 
JV11 

JV12 

JV20 

JV21 
JV31 



SAVE = E cJV string int string device 

(Level 3) 



: Out of memory while attempting DMA 
transfer (Option 3A only). 

(Level 2): RAS and RUN are valid for raster termi- 
nals only. 

(Level 2): Invalid thing-to-be-saved. (Must be MAC. 
SEG, RAS, or RUN. The latter two codes 
are valid for 4112,4113, and 4115 termi- 
nals only.) 

(Level 3): Out of memory while parsing parameter, 
or while executing the command. 

(Level 2): The specified macro or segment does not 
exist, or segment is being defined. 

(Level 2): Invalid item-number-or-count. 

(Level 2): Invalid separator (must be empty string or 
TO). 

JV32 (Level 3): Out of memory while parsing the 
parameter. 

JV40 (Level 2): The specified destination is not installed. 

JV41 (Level 2): Invalid destination specifier. 

JV42 (Level 2): Out of memory while parsing the parame- 
ter, or while executing the command. 

JV43 (Level 2): Not a valid destination device, device is 

busy, or existing disk file is write protected 
or open. 

JV49 (Level 2): Device hardware error. (I/O error, drive not 
ready, hardware write-protect error, or 
DMA block transfer error.) 
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KO: Keyboard System Errors 

K002 (Level 3): Out of memory while initializing the key- 
board system. 



KA ENABLE-DIALOG-AREA = E cKA int 

KA11 (Level 2): Invalid enable-mode (must be or 1). 

KC CANCEL = E cKC 

No errors are detected for this command. 



KM SET-MARGINS = E cKM int 

KMOO (Level 0): Unrecognized command. (The terminal is 
not a 41 14 or 41 16.) 

KM11 (Level 2): Invalid number-of-margins (must be from 
1 to 8). 



KN RENEW-VIEW = E cKN int 

KN02 (Level 3): Out of memory while attempting to renew 
a view. (This error can also occur as a 
result of pressing the PAGE key.)(41 12, 



KD DEFINE-MACRO = E cKD int int-array 

KD11 (Level 2): Invalid macro number (must be in range 
-32768 to -32742, -32740 to -32737, 
-32608 to -3251 3, or -1 to 32767). 

KD21 (Level 2): Invalid int-array (length must be from to 
65535, int values must be from to 1 27). 

KD22 (Level 3): Insufficient memory to define macro. 



KN 1 (Level 2): The view specified does not exist. 

KN11 (Level 2): Parameter out of range (must range from 
-32768 to 32767). 



KP SET-PAGE-FULL-ACTION = E cKP int 

KP11 (Level 2): \xwiaX\6 page- full-action. (Must range from 
to 7.) 



KE SET-ECHO = E cKE int 

KE11 (Level 2): Invalid echo-mode (must be or 1). 



KQ REPORT-ERRORS = E cKQ 

No errors are detected for this command. 



KF LFCR = E cKF int 

KF11 (Level 2): Invalid LFCR-mode (must be or 1). 

KH HARDCOPY = E cKH int 

KH01 (Level 2): Copier fault condition; operator assist- 
ance required (Option 9 only). 

KH 1 1 (Levei 2): invalid hard-copy-code (must be 0, 1 , or 
2). 



Kl 



IGNORE-DELETES = E cKI int 



Kl 1 1 (Level 2): Invalid ignore-deletes mode (must be 
0or1). 

KL LOCK-KEYBOARD = E cKL int 

KL1 1 (Level 2): Invalid keyboard-lock-mode (must be 
0or1). 



KR CRLF = E cKR int 

KR11 (Level 2): Invalid CRLF-mode (must be or 1). 

KS SET-SNOOPY-MODE = E cKS int 

KS11 (Level 2): Invalid snoopy-mode (must be or 1) 

KT SET-ERROR-THRESHOLD = E cKT int 

KT1 1 (Level 2): Invalid error-threshold-level (must be from 
to 4). 

KV RESET = E cKV 

No errors are detected for this command. 
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KX EXPAND-MACRO = E cKX int 

KX1 1 (Level 2): Invalid macro-number (must be from 
-32768 to -32742, -32740 to -32737, 
-32608 to -3251 3, or to 32767). 



KY SET-KEY-EXECUTE-CHAR = E cKY int 

KY1 1 (Level 2): Invalid key-execute-char (must range from 
0to127). 



KZ SET-EDIT-CHARS = E cKZ int int int 

KZ11 (Level 2): Invalid char-delete character (must range 
from to 127). 

KZ21 (Level 2): Invalid line-delete character (must range 
from to 127). 

KZ31 (Level 2): Invalid take-literally character (must 
range from to 127). 

LB SET-DIALOG-AREA-BUFFER-SIZE = E cLB int 

LB1 1 (Level 2): Invalid number-of -lines. (Must range from 
2 to 32767.) 



LH DRAW-MARKER = E cLH xy 

LH11 (Level 2): Invalid position (41 12, 4113, 4114, 4116: 
X = 0to4095,Y = to 4095; 411 5: X = 
to 4095 or -2 31 to 2 31 -1 , Y = to 4095 
or-2 31 to2 31 -1.) 



LI 



SET-DIALOG-AREA-INDEX = E cLI int int int 



LI00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

LI11 (Level 2): Invalid character-index. (Range is to 
32767.) 

LI21 (Level 2): Invalid character-background-index. 
(Range is to 32767.; 

LI31 (Level 2): Invalid wipe-index. (Range is to 32767.) 



LJ SET-DIALOG-AREA-ALTERNATE-INDEX = E cLJ int 

LJ00 (Level 0): Unrecognized command (terminal is not 
Version 4 or later; only valid for 41 12, 
4113, or 41 15). 

LJ11 (Level 2): Invalid index (range is to 65535). 



LC SET-DIALOG-AREA-CHARS = E cLC int 

LC11 (Level 2): Invalid number-of -chars. (4112, 4113: 5 to 
80; 41 14, 41 16: 5 to 819; 41 15: 5 to 160.) 



LE END-PANEL = F cLE 

LE00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115). 

LE03 (Level 1): No panel is currently being defined. 

LE02 (Level 3): Out of memory while performing END- 
PANEL command. 



LF MOVE = E cLFxy 

LF11 (Level 2): Invalid position (41 12, 4113, 4114, 4116: 
X = 0to4095,Y = to 4095; 411 5: X = 
to 4095 or -2 31 to 2 31 -1 , Y = to 4095 
or -2 31 to 2 31 -1 .) 



LG DRAW = E cLG xy 

LG11 (Level 2): Invalid postf/on (41 12, 4113, 4114, 4116: 
X = 0to4095,Y = to 4095; 411 5: X = 
to 4095 or -2 31 to 2 31 -1 , Y = to 4095 
or-2 31 to2 31 -1.) 



LK INCLUDE-COPY-OF-SEGMENT = E cLK int 

LK02 (Level 3): Out of memory while performing 

INCLUDE-COPY-OF-SEGMENT. (41 12, 
41 13 and 41 15 only). 

LK1 (Level 2): Segment does not exist. 

LK1 1 (Level 2): invalid segment-number (must be -3, -1 , 
or from 1 to 32767.) 

LK13 (Level 2): The segment specified is currently being 
defined. 



LL 



SET-DIALOG-AREA-LINES = E cLL int 



LL11 (Level 2): Invalid number-of -lines. (4112, 4113: 2 to 
34; 41 14, 41 1 6: 2 to 520; 41 1 5: 2 to 64.) 

LM SET-DIALOG-AREA-WRITING-MODE = E cLM int 

LM1 1 (Level 2): Invalid writing-mode (must be or 1 ). 
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LP BEGIN-PANEL-BOUNDARY = E cLP xy int 

LPOO (Level 0): Unrecognized command. (Terminal is not 
a4112,4113,ora4115.) 

LP02 (Level 3): Out of memory while defining panel. 

LP03 (Level 2): Alphatext is not allowed within ^panel- 
definition. When this error is detected, 
the panel being defined is closed, as if an 
END-PANEL command had been 
received. 

LP1 1 (Level 2): \rwa\\d first-point (41 12, 41 13: X = to 
4095, Y = to 4095; 41 1 5: X = to 4095 
or -2 31 to 2 31 -1 , Y = to 4095 or -2 31 to 
2 31 -1). 

LP21 (Level 2): Invalid draw-boundary-mode (must be 
or1). 



LS SET-DIALOG-AREA-SURFACE = E cLS int 

LS00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

LS1 1 (Level 2): invalid surface-number. (41 1 2: 1 to 3; 
4113:1 to 4; 41 15: 1 to 8.) 



LT GRAPHIC-TEXT = E cLT string 

LT03 (Level 2): Command is invalid at this time 

(graphtext is not allowed within a panel- 
definition). 

LT1 1 (Level 2): Invalid array count (must be from to 
65535). 

LT12 (Level 2): Out of memory while parsing the 
parameter. 



LV SET-DIALOG-AREA-VISIBILITY = E cLV int 

LV03 (Level 0): One or more of the dialog area parame- 
ters was altered when the dialog area was 
made visible. 

LV11 (Level 2): Invalid visibility-mode. (Must be or 1.) 



LX SET-DIALOG-AREA-POSITION = E cLX xy 

LX11 (Level 2): lnvalidposi?/'o«(4115: X or Y out of range 
to 4095). 



LZ CLEAR-DIALOG-SCROLL = E cLZ 

No errors are detected for this command. 

MA SET-GRAPHTEXT-SLANT = E cMA real 

MA00 (Level 0): Unrecognized command; firmware is 
Version 3 or earlier. 

MA1 1 (Level 2): Invalid slant-angle (must range from 
-32767.0 to 32767.0). 

MB SET-BACKGROUND-INDICES = E cMB int int 

MB00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115). 

MB11 (Level 2): Invalid text-background-index (must 
range from -2 to 32767). 

MB21 (Levei 2): invalid dash-gap-index (must range from 
-2 to 32767). 

MC SET-GRAPHTEXT-SIZE = E cMC int int int 

MC11 (Levei 2): invalid value in parameter 1. (4112, 4113, 
41 1 4, 41 1 6: 1 to 4095; 41 1 5: 1 to 2 31 -1 .) 

MC21 (Level 2): Invalid value in parameter 2. (4112, 4113, 
41 1 4, 41 1 6: 1 to 4095; 41 1 5: 1 to 2 31 -1 .) 

MC31 (Level 2): Invalid value in parameter 3. (4112, 4113, 
41 14, 41 1 6: to 4095; 41 1 5: to 2 31 -1 .) 



MD BEGIN-FILL-PATTERN = E cMD int int int int 

MD00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

MD02 (Level 3): Not enough memory available for fill 
pattern. 

MD03 (Level 2): Another fill pattern is currently being 
defined. 

MD11 (Level 2): \ma\\d fill-pattern-number (must range 
from 1 to 32767). 

MD21 (Level 2): Invalid pattern-width (41 1 2, 41 1 3: 1 to 32; 
4115:1 to 1280). 

MD31 (Level 2): \nva\\d pattern-height (4112, 4113: Oto 
480; 41 15:0 to 1024). 

MD41 (Level 2): Invalid bits-per-pixel (on the 41 1 2, must 
be 1 , 2, 3, or 6; on the 41 1 3, must be 1 , 2, 
3, 4, or 6; on the 41 1 5, must be 1 to 8). 
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ME END-FILL-PATTERN = E cME 

MEOO (Level 2): Unrecognized command. (Terminal is not 
a4112,4113,or4115). 



MR SET-GRAPHTEXT-ROTATION = E cMR real 

MR1 1 (Level 2): Invalid angle-in-degrees (must range from 
-32767.0 to 32767.0). 



MF SET-GRAPHTEXT-FONT = E cMF int 

MF10 (Level 2): Font is not defined. 

MF11 (Level 2): \r\va\\d font-number (must range from to 
32767). 

MG SET-GRAPHICS-AREA-WRITING-MODE = E cMG inl 

MG00 (Level 0): Unrecognized command. (Terminal is not 
a4ii2,41i3, nr 4115.) 

MG11 (Level 2): Invalid writing-mode. (Must be or 1.) 



Ml 



SET-PICK-ID = E cMI int 



MI03 (Level 2): Command is invalid at this time. (No seg- 
ment is currently being defined.) 

MI1 1 (Level 2): Invalid pick-number. (Must range from 
to 32767.) 

ML SET-LINE-INDEX = E cML int 

ML11 (Level 2): Invalid line-index. (Must range from to 
32767.) 

MM SET-MARKER-TYPE = E cMM int 

MM1 1 (Level 2): Invalid marker-number (must be from 
0to10). 

MP SELECT-FILL-PATTERN = E cMP int 

MP00 (Level 2): Unrecognized command. (The terminal is 
not a 41 12, 4113, or 41 15.) 

MP10 (Level 2): Specified fill-pattern has not been 
defined. 

MP11 (Level 2): \nva\\d fill-pattern (must range from 
-32768 to 32767.) 

MQ SET-GRAPHTEXT-PRECISION = E cMQ int 

MQ11 (Level 2): Invalidpreczsz'on mode (must be 1 or 2). 



MS SET-PANEL-FILLING-MODE = E cMS int int int 

MS00 (Level 0): Unrecognized command. (Terminal is not 
a4112,4113,or4115.) 

MS1 1 (Level 2): Invalid overstrike/ replace mode (must be 
0or1). 

MS21 (Level 2): Invalid cover-boundary mode (must be 
or1). 

MS31 (Level?)- Invalid poll em-key ing-mode (must be 
from to 3). 



MT SET-TEXT-INDEX = E cMT int 

MT1 1 (Level 2): Invalid text-index. (Must range from to 
65535.) 



MV SET-LINE-STYLE = E cMV int 

MV11 (Level 2): Invalid line-style. (Must range from to 7.) 

MW SET-LINE-WIDTH = E cMW int 

MW00 (Level 0): Unrecognized command. (The terminal is 
not a 41 14 or 41 16.) 

MW1 1 (Level 2): Invalid width. (Must be or 1 .) 

MY SELECT-ALPHATEXT-SIZE-GROUP = E cMY int 

MY00 (Level 0): Unrecognized command (terminal is not a 
4114or4116). 

MY11 (Level 2): Invalid group (must be either or 1). 

MZ SET-ALPHATEXT-SIZE = E cMZ int int int 

MZ00 (Level 0): Unrecognized command. (Terminal is not 
a 41 14 or 41 16.) 

MZ1 1 (Level 2): Invalid size-multiplier (must range from 1 
to 16). 

MZ21 (Level 2): Invalid inter-character-spacing (must 
range from to 15). 

MZ31 (Level 2): Invalid interline-spacing (must range from 
to 255). 
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NB SET-STOP-BITS = E cNB int 

NB11 (Levs',2): Invalid number-of-stop-hits (must be 1 or 
2). 



NC SET-EOM-CHARS = E cNC int int 

NC11 (Level 2): Invalid EOM-char-1. (Must range from 
to 127.) 

NC21 (Level 2): Invalid EOM-char-2. (Must range from 
to 127.) 



ND SET-TRANSMIT-DELAY = E cND int 

ND11 (Level 2): Invalid transmit-delay. (Must range from 
to 65535.) 



I^C bt I'Cur-O l nil^U — oiii- inraiiaji 

NE1 1 (Level 2): Invalid EOF-string (must contain from 
to 10 characters, with each character 
represented by an int in the range from 
to 127). 

NE12 (Level 3): Out of memory while parsing the 
parameter. 



NF SET-FLAGGING-MODE = E cNF int 

NF1 1 (Level 2): Invalid flagging-mode (must be from 
to 4). 



NK SET-BREAK-TIME = E cNK int 

NK1 1 (Level 2): Invalid parameter. (Must range from to 
65535.) 



NL SET-TRANSMIT-RATE-LIMIT = E cNL int 

NL11 (Level 2): Invalid rate-limit. (Must range from 110 to 
65535.) 



NM PROMPT-MODE = E cNM int 

NM11 (Level2): Invalid prompt-mode (must be 0, 1, or 2). 

NP SET-PARITY = E cNP int 

NP1 1 (Level 2): Invalid parity-mode. (Must be from to 4.) 



NQ SET-QUEUE-SIZE = E cNQ int 

NQ01 (Level 3): Not all memory freed from queue. 

NQ02 (Level 3): Out of memory while performing SET- 
QUEUE-SIZE command. 

NQ11 (Level 2): Invalid queue-size. (Must range from 1 to 
65535.) 

NR SET-BAUD-RATES = E cNR int int 

NR11 (Level 2): Invalid transmit-data-rate. (Must be 1 , 50, 
75 110 134, 150, 300, 600, 1200, 1800, 
2000, 2400, 4800, 9600, 19200, or 
38400.) 

NR21 (Level 2): Invalid receive-data-rate. (Must be 0, 1 , 
50, 75, 1 1 0, 1 34, 1 50, 300, 600, 1 200, 
1800, 2000, 2400, 4800, 9600, 19200, or 
38400.) 

NS SET-PROMPT-STRING = E cNS int-array 

NS1 1 (Level 2): Invalid prompt-string. (Must be an array 
holding from to 10 int parameters. Each 
of the items in the array must be an int in 
the range from to 1 27.) 

NS12 (Level 3): Out of memory while parsing the 
parameter. 

NT SET-EOL-STRING = E cNT int-array 

NT11 (Level 2): Invalid EOL-string. (The array must hold 
from to 2 int parameters. Each int in the 
array must be in me ianyc nuui u iu \a ./ 

NT1 2 (Level 3): Out of memory while parsing the 
parameter. 



NU 



SET-BYPASS-CANCEL-CHAR = E cNU int 



NU11 (Level 2): Invalid numeric equivalent of bypass- 
cancel-character. (Must range from to 
127.) 

OB ARM-FOR-BLOCK-MODE = E cOB int 

OB00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OB03 (Level 2): The communications queue size is 

smaller than the specified input block 
size. 

OB1 1 (Level 2): Invalid block-mode-arming parameter 
(must be or 1). 
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OC SET-BLOCK-CONTINUE-CHARS = E cOC int int 

OC00 (Level 2): Unrecognized command. (Option 1 is not 
installed.) 

OC03 (Level 2): Command is invalid at this time. (Terminal 
must not be armed for block mode.) 

OC1 1 (Level 2): Invalid transmit-continue-char. (Must 
range from to 127.) 

OC1 3 (Level 2): Transmit-continue-char must be 

different from block-master-char and 
block-end-char. 

OC21 (Level 2): Invalid receive-continue-char. (Must range 
from to 127.) 

OC23 (Level 2): Receive-continue-char must be 

different from block-master-char and 
block-end-char. 



OD SET-DUPLEX-MODE = E cOD int 

OD00 (Level 0): Unrecognized command. (Option 01 is 
not installed.) 

OD01 (Level 2): Invalid duplex-mode (must be to 3). 



OE SET-BLOCK-END-CHARS = E cOE int int 

OE00 (Level 2): Unrecognized command. (Option 1 is not 
installed.) 

OE03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OE11 (Level 2): Invalid transmit-end-char. (Must range 
from to 127.) 

OE13 (Level 2): Transmit-end-char must be 

different from block-master-char and 
block-continue-char. 

OE21 (Level 2): Invalid receive-end-char. (Must range from 
to 127.) 

OE23 (Level 2): Receive-end-char must be 

different from block-master-char and 
block-continue-char. 



OH SET-BLOCK-HEADERS = E cOH int-array int-array 

OH00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OH02 (Level 3): Out of memory while performing 
command. 

OH03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OH11 (Level 2): Invalid c/zar (must beOto 127) or array 
count (must be in range to 1 0) in 
transmit-header. 

OH 12 (Level 3): Out of memory while parsing the 
parameter. 

OH21 (Level 2): Invalid char (must be O to 1 27) or array 

count (must be in range to 1 0) in receive- 
header. 

OH22 (Level 3): Out of memory while parsing the 
parameter. 

OL SET-BLOCK-LINE-LENGTH = E cOL int 

OL00 (Level 2): Unrecognized command. (Option 01 not 
installed.) 

OL03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode). 

OL1 1 (Level 2): Invalid maximum-line-length. (Must range 
from 12 to 65535.) 

OM SET-BLOCK-MASTER-CHARS = E cOM int int 

OM00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OM03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OM 1 1 (Level 2): Invalid transmit-master-char (0 to 1 27). 

OM13 (Level 2): Transmit-master-char must be 

different from block-end-char and 
block-continue-char. 

OM21 (Level 2): Invalid receive-master-char (0 to 1 27). 

OM23 (Level 2): Receive-master-char must be 

different from block-end-char and 
block-continue-char. 
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ON SET-BLOCK-NON-XMT-CHARS = E cON int-array 
int-array 

ON00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

ON03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

ON11 (Level 2): Invalid character code or array count in 
transmit-chars. (The array count must be 
from to 20, and the character codes 
must be from to 1 27.) 

ON 12 (Level 3): Out of memory while parsing the 
parameter. 

ON21 (Level 2): Invalid character code or array count in 
receive-chars. (The array count must be 
from to 20, and the character code must 
be from to 1 27.) 

ON22 (Level 3): Out of memory while parsing the 
parameter. 



OP SET-BLOCK-PACKING = E cOP int int int int 

OP00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OP03 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OP1 1 (Level 2): Invalid transmit-unpacked-bits (must be 7 
or 8). 

OP21 (Level 2): Invalid transmit-packed-bits (must be 6, 7, 
or 8). 

OP31 (Level 2): Invalid receive-unpacked-bits (must be 7 
or 8). 

OP41 (Level 2): \n\ia\\6 receive-packed-bits (must be Q, 7, 
or 8). 



OS SET-BLOCK-LENGTH = E cOS int int 

OS00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OS03 (Level 2): Command invalid at this time. (Terminal 
must not be or armed for block mode.) 

OS1 1 (Level 2): Invalid transmit-block-length (must range 
from 5 to 65535.) 

OS21 (Level 2): Invalid receive-block-length (must range 
from 5 to 65535.) 



ERROR CODES 



OT SET-BLOCK-TIMEOUT = E cOT int 

OT00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OT1 1 (Level 2): Invalid timeout. (Must range from to 
65535 seconds.) 



PA PORT-ASSIGN = E cPA device string int 

PA00 (Level 0): Unrecognized command. (Option 10 is 
not installed.) 

DA -1 -1 /i nt ./-if 0\. In..ni:^ * \ ~J Lit! /* M. ._ a I f%A P»J 

i r\ i i (i.evra t). nivaiiu //<« i luenuiici. (iviusi ue Pu:, Pi:, 
or P2:.) 

PA12 (Level 3): Out of memory while parsing the 
parameter 

PA1 3 (Level 2): Port is in use. 

PA21 (Level 2): Invalid protocol identifier. (Must be 

PPORT, 4643, 4662, 4662/MP, 4662/NT, 
4663, 4663/NB, 4663/NT, or KATA). 

PA22 (Level 3): Out of memory while parsing parameter. 

PB SET-PORT-STOP-BITS = E cPB device int int 

PB00 (Level 0): Unrecognized command. (Option 10 is 
not installed.) 

PB11 (Level 2): Port identifier is invalid (must be P0:, P1:, 
or P2:). 

PB12 (Level 3): Out of memory while parsing the 
parameter. 

PR13 l\ evel 2^ Pr>rt is b"«=" 

PB21 (Level 2): Invalid number-of-stop-bits (must be 
lor 2). 

PB31 (Level 2): Invalid number-of-data-bits (must be 5, 6, 
7, or 8). 
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ERROR CODES 



PC PORT-COPY = E cPC device string device 

PCOO (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PC02 (Level 3): Out of memory while processing 
command. 

PC10 (Level 2): Source device does not exist. 

PC11 (Level2): Invalid sowrce(must be HO:, P0:, P1:,or 
P2:). 

PC12 (Level 3): Out of memory while parsing the 
parameter. 

PC13 (Level 2): Source is busy, or is a peripheral port that 
is not assigned the PPORT protocol. 

PC21 (Level 2): Invalid separator. (Must be the empty 
string or TO.) 

PC22 (Level 3): Out of memory while parsing the 
parameter 

PC30 (Level 2): Destination device is not installed. 

PC31 (Level 2): Invalid destination (must be HO:, P0:, P1: 
or P2:, and must be different from the 
source port). 

PC32 (Level 3): Out of memory while parsing the 
parameter. 

PC33 (Level 2): Destination is busy or is a peripheral port 
that is not assigned the PPORT protocol. 



PE SET-PORT-EOF-STRING = E cPE device int-array 

PE00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PE11 (Level2): Invalid/wf identifier (must be P0:, P1:, or 
P2:). 

PE12 (Level 3): Out of memory while parsing the 
parameter. 

PE13 (Level 2): Port is busy. 

PE21 (Level 2): Invalid EOF-string. (The int-array must 
have from to 10 elements, and each int 
in the array must be in the range from to 
127.) 

PE22 (Level 3): Out of memory while parsing the 
parameter. 



PF SET-PORT-FLAGGING-MODE = E cPF device int int 
int 

PF00 (Level 0): Unrecognized command. (Option 10 is 
not installed.) 

PF11 (Level 2): Invalid port identifier (must be P0:, P1:, or 
P2:). 

PF12 (Level 3): Out of memory while parsing the 
parameter. 

PF13 (Level 2): Port is busy. 

PF21 (Level 2): Invalid flagging-mode (must be 0, 1 or 2). 

PF31 (Level 2): Invalid GO character (must be in range 
to 127). 

PF41 (Level 2): Invalid STOP character (must be in range 
to 127; if non-zero, must be different 
from the GO character). 

PI MAP-INDEX-TO-PEN = E cPI device int int 

PI00 (Level 0): Unrecognized command. (Option 10 is 
not installed.) 

PI02 (Level 3): No memory is available for the index map. 

PI11 (Level2): Invalid port identifier (must be P0:, P1:, or 
P2:). 

P1 12 (Level 2): Out of memory while parsing the 
parameter. 



PI13 (Level 2) 
PI21 (Level 2) 
PI31 (Level 2) 



Port is busy. 

Invalid /Hate*: (must range from -1 to 255). 

Invalid pen-number (must range from to 
255). 
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ERROR CODES 



PL 

PLOO 

PL02 

PL11 

PL12 

PL20 
PL21 
PL22 

PL23 

PL29 



PM 

PMOO 

PM11 

PM12 

PM13 
PM22 

PP 

PPOO 

PP11 

PP12 

PP13 
PP21 



PLOT = E cPL string device 

Level 0): Unrecognized command. (Option 10 is 
not installed.) 

Level 3): Out of memory while attempting DMA 
transfer (Option 3A only). 

Level 2): Invalid separator. (Must be the empty 
string or TO.) 

Level 3): Out of memory while parsing the 
parameter. 

Level 2): Destination device not installed. 

Level 2): Invalid destination specifier 

Level 3): Out of memory while parsing the 
parameter. 

Level 2): Parameter 2 context error. (Device is write 
protected or busy.) 

Level 2): Device hardware error (disk drive is not 
ready or is write-protected, or DMA block 
transfer error). 



SET-PORT-EOL-STRING = E cPM device int-array 

Level 0): Unrecognized command. (Option 10 is 
not installed.) 

Level 2): Invalidporf identifier. (Must be P0:, P1 :, 
orP2:.) 

Level 3): Out of memory while parsing the 
parameter. 

Level 2): Port is busy. 

Level 3): Out of memory while parsing the 
parameter. 



SET-PORT-PARITY = E cPP device int 

Level 0): Unrecognized command. (Option 10 is 
not installed). 

Level 2): Invalid port specifier (must be P0:, P1:, or 
P2:). 

Level 3): Out of memory while parsing the 
parameter. 

Level 2): Port is busy. 

Level 2): Invalid parity-mode (must be in range to 
4). 



PQ REPORT-PORT-STATUS = E cPQ device 

PQ00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PQ11 (Level2): Invalid port identifier (must be P0:, P1:, or 
P2:). 

PQ1 2 (Level 3): Out of memory while parsing the 
parameter. 



PR SET-PORT-BAUD-RATE = E cPR device int 

PR00 (Level 0): Unrecognized command. (Option 10 is 
not installed). 

PR11 (Level 2): \ma\\6 port identifier (must be P0:, P1:, or 
P2:). 

PR12 (Level 3): Out of memory while parsing the 
parameter. 

PR13 (Level 2): Port is busy. 

PR21 (Level2): Invalid 6a«c/-rate (must be50, 75, 110, 
134, 150, 300, 600, 1200, 1800, 2000, 
2400, 3600, 4800, 7200, or 9600). 

QB SET-COLOR-COPIER-DATA-RESOLUTION = E cQB 
int 

QB00 (Level 0): Unrecognized command (Option 9 is not 
installed). 

QB1 1 (Level 2): Invalid resolution (must be 1 or 2). 

QD SELECT-HARDCOPY-INTERFACE = E cQD int 

QD00 (Level 0): Unrecognized command (Option 9 is not 
installed). 

QD11 (Level 2): Invalid interface (must be or 1). 

QN SET-NUMBER-OF-COPIES = E cQN int 

QN00 (Level 0): Unrecognized command (Option 9 is not 
installed). 

QN11 (Level 2): Invalid number-of-copies (must be or 
65535). 
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ERROR CODES 



QO SET-IMAGE-ORIENTATION = E cQO int 

QO00 (Level 0): Unrecognized command (Option 9 is not 
installed). 

Q011 (Level 2): Invalid orientation (must be from to 3). 



QQ REPORT-COLORHARDCOPY-STATUS = E cQQ 

QQ00 (Level 0): Unrecognized command (Option 9 is not 
installed). 



RA SET-VIEW-ATTRIBUTES = E cRA int int int 

RA00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RA1 (Level 2): Surface does not exist (has not 

been defined with SET-SURFACE- 
DEFINITIONS command). 

RA1 1 (Level 2): Invalid surface-number. (41 1 2: -1 to 3; 
41 1 3: -1 to 4; 41 1 5: -1 to 8.) 

RA21 (Level 2): Invalid wipe-index. (Must range from to 
65535.) 

RA31 (Level 2): Invalid border-index. (Must range from 
to 65535.) 



RB SET-BACKGROUND-GRAY-LEVEL = E cRB int 

RB00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RB1 1 (Level 2): Invalid gray-level (must range from to 
100 or 1000 to 11 00). 



RC SELECT-VIEW = E cRC int 

RC00 (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 4113, or 41 15.) 

RC1 1 (Level 2): Invalid view-number. (Must range from -1 
to 64.) 



RD SET-SURFACE-DEFINITIONS = E cRD int-array 

RD00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RD10 (Level 2): Occupied undefined surface. (This com- 
mand would have resulted in a dialog 
area viewport, pixel viewport, or num- 
bered graphic viewport residing on an 
undefined surface.) 

RD1 1 (Level 2): Invalid surface-defs array. (41 1 2: array 
count: 1 to 3; ints: to 3; 41 1 3: array 
count: 1 to 4; ints: to 4; 41 1 5: array 
count: 1 to 8; ints: to 8.) 

RD12 (Level 3): Out of memory while parsing the 
parameter. 

RE SET-BORDER-VISIBILITY = E cRE int 

RE00 (Level 0): Unrecognized command. (The terminal is 
nota4112, 4113, or 4115.) 

RE 11 (Level 2): Invalid border-visibility-mode parameter 
(must be 0, 1,or2). 

RF SET-FIXUP-LEVEL = e cRF int 

RF00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RF1 1 (Level 2): Invalid fixup-level (must range from to 
32767). 

RG SET-SURFACE-GRAY-LEVELS = E cRG int int-array 

RG00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RG10 (Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 

RG1 1 (Level 2): Invalid surface-number. (41 12: -1 or 1 to 
3; 41 13: -1 or 1 to 4; 4115: -1 or 1 to 8.) 

RG21 (Level 2): Invalid surface-gray-levels array. (The 

array count must be even; the first int in 
each pair must be a color index in the 
range from 1 to 32767; the second int in 
each pair must be a valid gray-level: a 
number from to 1 00 or 1 000 to 1 1 00.) 

RG22 (Level 3): Out of memory while parsing the 
parameter. 
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RH SET-PIXEL-BEAM-POSITION = E cRH xy 

RHOO (Level 0): Unrecognized command. (The terminal is 
nota4112, 4113, or4115.) 

RH11 (Level 2): Invalid beam-position (4115: -2 31 to 
2 31 -1). 



Rl SET-SURFACE-VISIBILITY = E cRI int-array 

RI00 (Level 0): Unrecognized command, (The terminal is 
nota4112,4113,or4115.) 

RMO (Levei 2): A surface in surface-numbers-and-visibili- 
ties does not exist (has not been defined 
with a SET-SURFACE-DEFINITIONS 
command). 

RI11 (Level 2): Invalid surface-numbers-and-visibilities 
array. (Surface numbers: 41 12: 1 to 3; 
41 1 3: 1 to 4; 41 1 5: 1 to 8. Visibility: to 2 
for all terminals. Array count must be 
even and range from 2 to 65534.) 

RI12 (Level 3): Out of memory while parsing the 
parameter. 

RJ LOCK-VIEWING-KEYS = E cRJ int 

RJ00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RJ11 (Level 2): Invalid locking-mode (must be or 1). 



RK DELETE-VIEW = E cRK int 

Ql/TlA (\ £>\*qI n\- I InronArtniTe^ oAmmonH /Tho +<a i*rvti r» £* I ie 
i n\uu |lCVCi \Jf. ±st il Gi^v^i ii^Su ^vi C*i ivj. ^ i i it? id ■ ■ in iui w 

not a 41 12, 4113, or 41 15.) 

RK10 (Level 1): The designated view does not exist (has 
not been defined with a SELECT-VIEW 
command). 

RK1 1 (Level 2): Invalid view-number (must range from -1 
to 64). 



RL RUNLENGTH-WRITE = E cRL int-array 

RL00 (Level 2): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RL1 1 (Level 2): Invalid runlength-code array. (The array 
count must range from to 65535, and 
each int in the array must also range from 
to 65535 on a 41 1 2 and 4113, and from 
0to2 31 -1 on a 41 15.) 

RL12 (Level 3): Out of memory while parsing the parame- 
ter, or while executing the command. 



RN SET-SURFACE-PRIORITIES = E cRN int-array 

RN00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RN10 (Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 

RN 1 1 (Level 2): Invalid priorities array. (Surfaces: 4112:1 
to 3; 41 1 3: 1 to 4; 41 1 5: 1 to 8. Priorities: 
41 12:0 to 4; 41 13:0 to 5; 41 15:0 to 9.) 

RN12 (Level 3): Out of memory while parsing the 
parameter. 



RP RASTER-WRITE = E cRP int char-array 

RP00 (Level 0): Unrecognized command. (The terminal is 
nota4112, 4113, or 4115.) 

RP1 1 (Level 2): Invalid number-oj '-pixels. (Must range 
from to 65535.) 

RP21 (Level 2): There are too many or too few pixels in 
the code-array, or invalid codes are 
present (range for codes is ADE 32 to 96). 

RP22 (Level 3): Out of memory while parsing the 
parameter. 



RQ SET-VIEW-DISPLAY-CLUSTER = E cRQ int-array 

RQ00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115). 

RQ1 1 (Level 2): Invalid view-numbers array. (Each view 
number must range from -2 to 64; array 
count must be from to 65535.) 

RQ12 (Level 3): Out of memory while parsing the 
parameter. 
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RR RECTANGLE-FILL = F cRR xy xy int 

RROO (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RR11 (Level2): Invalid first-corner. (4112, 4113: X = Oto 
639, Y = Oto 479; 41 15: X = Oto 1279, Y 
= Oto 1023.) 

RR21 (Level 2): Invalid second-corner. (41 1 2, 41 1 3: X = 
to 639, Y = Oto 479; 41 15: X = Oto 1279, 
Y = Oto 1023.) 

RR31 (Level 2): \nva\\d fill-index (must range from to 
65535.) 



RS SET-PIXEL-ViEWPORT = F cRS xy xy 

RS00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RS1 1 (Level 2): \nva\\d first-corner. (41 1 2, 41 1 3: X = to 
639, Y = to 479; 4115: X = Oto 1279, Y 
= Oto 1023.) 

RS21 (Level 2): Invalid second-corner. (41 1 2, 41 1 3: X = 
to 639, Y = 0to479;4115:X = 0to1279, 
Y = Oto 1023.) 

RT SET-PIXEL-WRITING-FACTORS = E cRT int int int 

RT00 (Level 0): Unrecognized command. (Terminal is not 
a 41 15.) 

RT1 1 (Level 2): Invalid pixel-width parameter (range is 
-1280 to 1280). 

RT21 (Level 2): Invalid pixel-height parameter (range is 
-1280 to 1280). 

RT31 (Level 2): Invalid major-axis parameter (must be 
or1). 

RU BEGIN-PIXEL-OPERATIONS = E cRU int int int 

RU00 (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 4113, or 41 15.) 

RU10 (Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 

RU1 1 (Level 2): Invalid surface-number. (41 1 2: -1 to 3; 
4113: -1 to 4; 41 15: -1 to 8.) 

RU21 (Level 2): Invalid ALU-mode (41 12, 4113: Oto 16; 
4115:0,7, 11, 12,15, 17, or 18). 

RU31 (Level 2): Invalid bits-per-pixel. (41 1 2: 0, 1 , 2, 3, or 
6; 41 13: 0, 1 , 2, 3, 4, or 6; 41 1 5: to 8.) 



RV SET-VIEWPORT = E cRVxyxy 

RV00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RV01 (Level 2): Invalid viewport size. (In the 41 12 and 
41 13, the viewport must not be more 
than 51 .2 times larger than the current 
window.) 

RV1 1 (Level 2): Invalid first-corner. (41 12, 41 13: X = to 
4095, Y = to 3071; 41 15: X = Oto 
4095, Y = to 3276.) 

RV21 (Level 2): Invalid second-corner. (41 1 2, 41 1 3: X = 
to 4095, Y = to 3071; 4115: X = Oto 
4095, Y = tO 3276.) 

RW SET-WINDOW = E cRW xy xy 

RW00 (Level 0): Unrecognized command. (The terminal is 
not a 41 12, 41 13, or 41 15.) 

RW01 (Level 2): Invalid window size. (In the 41 12 and 
4113, the viewport must not be more 
than 51 .2 times larger than the current 

window.) 

RW1 1 (Level 2): \nva\\dfirst-corner(4-\-\2, 41 13: X = to 
4095, Y = to 4095; 41 1 5: X = to 4095 
or -2 31 to 2 31 -1 , Y = to 4095 or -2 31 to 
2 31 -1). 

RW21 (Level 2): Invalid second-corner (41 12, 4113: X = 
to 4095, Y = to 4095; 41 1 5: X = to 
4095 or -2 31 to 2 31 -1 , Y = to 4095 or - 
2 31 to 
2 31 -1). 

RX PIXEL-COPY = E cRX int xy xy xy 

RX00 (Level 0): Unrecognized command. (The terminal is 
nota4112,4113,or4115.) 

RX1 (Level 2): The specified destination-surface does 
not exist. 

RX1 1 (Level 2): Invalid destination-surface. (41 1 2: -1 to 3; 
4113:-1 to 4; 41 15: -1 to 8.) 

RX21 (Level 2): Invalid destination-lower-left-corner. 

(4112,4113:X = 0to639,Y = 0to479; 
4115:X = Oto 1279, Y = Oto 1023.) 

RX31 (Level 2): Invalid first-source-corner. (41 12,411 3: 
X = Oto 639, Y = to 479; 4115: X = 
to 1279, Y = Oto 1023.) 

RX41 (Level 2): Invalid second-source-corner. (41 1 2, 
4113: 

X = Oto 639, Y = Oto 479; 41 15: X = 
to 1279. Y = Oto 1023.) 



C-22 



41 10 SERIES COMMAND REFERENCE 



ERROR CODES 



SA 

SA03 

SA10 
SA11 

SA21 



SET-SEGMENT-CLASS = E cSA int int-array int-array SE BEGIN-NEW-SEGMENT = E cSE int 



(Level 2): Command invalid at this time: the speci- 
fied segment is currently being defined. 

(Level 2): Segment does not exist. 

(Level 2): Invalid segment-number. (Must be in the 
range from -3 to -1 , or from 1 to 32767.) 

(Level 2): Invalid removal-array. (Each class num- 
ber must be -1 or from 1 to 64; array 
count must be from to 65535.) 



SA22 (Levei3): Out of memory while parsing ti 
SA31 



parameter. 



(Level 2): Invalid addition-array. (Each class num- 
ber must be -1 or from 1 to 64; array 
count must be from to 65535.) 

bAo^ (i_evtJi o). vjui ui memut y wi met jjaiou iy incr 

parameter. 



SB BEGIN-LOWER-SEGMENT = E cSB 

SBOO (Level 0): Unrecognized command (the terminal 
firmware is version 1 or 2). 

SBOO (Level 2): The indicated segment already exists. 

SB01 (Level 2): Invalid for next lower segment number 
(current segment ID is 1). 

SB02 (Level 3): Not enough memory to begin segment, or 
out of memory while ending segment. 

SB03 (Level 2): Context error; command is invalid at this 
time. No segment is currently being 
defined, or a graphtext character is cur- 
rently being defined. 



SC END-SEGMENT = E cSC 

SC02 (Level 3): Out of memory while performing com- 
mand (4112,4113,4115 only). 

SC03 (Level 1 ): Invalid at this time: no segment is cur- 
rently being defined. 

SD SET-SEGMENT-DETECTABILITY = E cSD int int 

SD03 (Level 2): Command is invalid at this time. (The 

specified segment is currently being 
defined.) 

SD10 (Level 2): Segment does not exist. 

SD1 1 (Level 2): invalid segment-number (must range from 
-3 to -1 , or 1 to 32767). 

SD21 (Level 2): Invalid detectability (must be or 1 ). 



SE00 (Level 0): Unrecognized command (the terminal 
firmware is version 1 or 2). 

SE02 (Level 3): Not enough memory to begin segment, or 
out of memory while ending segment. 

SE BEGIN-NEW-SEGMENT = E cSE int 

SE00 (Level 0): Unrecognized command (the terminal 
firmware is version 1 or 2). 

OCnO /I anal QV MM anni inh mamnr\j tn hflnin eonmflnt r\r 

out of memory while ending segment. 

SE03 (Level 2): Command is invalid at this time (a 

graphtext character or a panel is currently 
being defined without a segment being 
defined). 

SE10 (Level 2): Segment already exists. 

SE11 (Level 2): Invalid segment-number {\ through 32767 
are valid). 



SG SET-GRAPHTEXT-FONT-GRID = E cSG int int int 

SG02 (Level 3) Out of memory while defining font grid. 

SG10 (Level 2) Font already exists. 

SG1 1 (Level 2) \nva\\d font-number (must range from to 
32767). 

SG21 (Level 2) Invalid grid-width. (Must range from 1 to 
4095.) 

SG31 (Level 2) Invalid grid-height. (Must range from 1 to 
4095.) 

SH SET-SEGMENT-HIGHLIGHTING = E cSH int int 

SH03 (Level 2) Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

SH10 (Level 2) Segment does not exist. 

SH11 (Level 2) Invalid segment-number (must range from 
-3 to -1 , or from 1 to 32767). 

SH21 (Level 2) Invalid highlighting (must be or 1). 
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SI SET-SEGMENT-IMAGE-TRANSFORM = E cSI int 

real real real xy 



SL SET-CURRENT-MATCHING-CLASS = E cSL int- 
array int-array 



5102 (Level 3) Out of memory while transforming 

segment. 

5103 (Level 2) Command is invalid at this time. (The 

specified segment is currently being 
defined.) 



SL1 1 (Level 2) Invalid inclusion-set. (Class numbers 
must be -1 , or from 1 to 64; the array 
count must be from to 65535.) 

SL12 (Level 3) Out of memory while parsing the 
parameter. 



51 10 (Level 2) Segment does not exist. 

5111 (Level 2) Invalid seement-number (must ranqe -3 to 

-1 , or 1 to 32767). 

SI21 (Level 2) Invalid x-scale-f actor. (Must range from 
-32767.0 to 32767.0.) 

SI31 (Level 2) Invalid y-scale-f actor. (Must range from 
-32767.0 to 32767.0.) 

SI41 (Level 2) Invalid rotation-angle. (Must range from 
-32767.0 to 32767.0.) 

SI51 (Level 2) Invalid position. (4112, 4113, 4114, 4116: 
X = 0to4095,Y = to 4095; 411 5: X = 
to 4095 or -2 31 to 2 31 -1 ; Y = to 4095 
or-2 31 to2 31 -1.) 

SK DELETE-SEGMENT = E cSK int 

SK02 (Level 3) Out of memory while attempting to delete 
a segment (4112,4113.4115 only). 

SK10 (Level 1) Segment does not exist. 

SK1 1 (Level 2) Invalid segment-number (must be -3, -1 , 
or from 1 to 32767). 

SK1 3 (Level 2) Segment specified is an active 
GIN-cursor. 



SL21 (Level 2) Invalid exclusion-set. (Class numbers 
must be -1 , or from 1 to 64; the array 
count must be from to 65535.) 

SL22 (Level 3) Out of memory while parsing the 
parameter. 

SM SET-SEGMENT-WRITING-MODE = E cSM int int 

SM03 (Level 2) Command is invalid at this time. (The 
specified segment is currently being 
defined. 

SM 1 (Level 2) Segment does not exist. 

SM1 1 (Level 2) Invalid segment-number (must range from 
-3 to 32767). 

SM21 (Level 2) Invalid writing-mode (must be or 1 ). 

SN BEGIN-HIGHER-SEGMENT = E cSN 

SN00 (Level 0) Unrecognized command (the terminal 
firmware is version 1 or 2). 

SN00 (Level 2) The indicated segment already exists. 

SN01 (Level 2) Invalid for next higher segment number 
(current segment ID is 32767). 

SN02 (Level 3) Not enough memory to begin segment, or 
out of memory while ending segment. 



SN03 (Level 2) No segment is currently being defined, or 
a graphtext character is currently being 
defined. 
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SO BEGIN-SEGMENT = E cSO int 



SR RENAME-SEGMENT = E cSR int int 



SO02 (Level 3) Not enough memory to begin segment, or SR02 (Level 3) Out of memory while renaming a segment 
out of memory while defining segment. (4114,4116 only). 



SO03 (Level 2) Another segment, a graphtext character, 
or a panel is currently being defined. 

5010 (Levei2) Segment already exists. 

501 1 (Level 2) Invalid segment-number (must range from 

1 to 32767). 

SP SET-PIVOT-POINT = E cSP xy 



SP11 (Level 2) Invalid pivot-point (411 5: X and Y must 

befrom-2 31 to2 31 -1). 



SQ REPORT-SEGMENT-STATUS = E cSQ int char-array 

SQ10 (Level 2) Segment does not exist. 

SQ1 1 (Level 2) Invalid segment-number (must range from 
-3 to 32767). 



SR03 (Level 2) Command is invalid at this time. (The 
specified segment is currently being 
defined.) 



SR1 (Level 2) Segment does not exist. 

SR1 1 (Level 2) Invalid old-segment-number (must range 
from 1 to 32767). 

SR20 (Level 2) A segment with the old-segment-number 



SR21 (Level 2) Invalid new-segment-number (must range 
from 1 to 32767). 

SS SET-SEGMENT-DISPLAY-PRIORITY = E cSS int int 

SS03 (Level 2) Command is invalid at this time. (The 
specified segment is currently being 
defined.) 



SQ21 (Level 2) Invalid array of codes. (Must include only 
the uppercase letters A, D, H, I, M, P, S, V, 
and X. Also, the array count must be in 
the ran^e from to 65535.) 

SQ22 (Level3) Out of memory while parsing the 
parameter. 



551 (Level 2) Segment does not exist. 

551 1 (Level 2) Invalid segment-number (must range from 

-3 to -1 , or from 1 to 32767). 

SS21 (Level 2) Invalid priority-number (must range from 
-32768 to 32767). 
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ST BEGIN-GRAPHTEXT-CHARACTER = E cST int int 



SV SET-SEGMENT-VISIBILITY = E cSV int 



ST02 (Level 3) Out of memory while defining graphtext 
character, or not enough memory to begin 
the definition. 



ST03 (Level 2) Command is invalid at this time. (A 

graphtext character is currently being 
defined.) 

ST1 (Level 2) The font specified has no grid defined for 
it. 

ST11 (Level 2) Invalid /on? number (the range is from to 
32767). 



SV02 (Level 3) Out of memory while performing com- 
mand (41 1 2, 41 1 3, 41 1 5 only.) 

SV03 (Level 2) Command is invalid at this time. (The 
specified segment is currently being 
defined.) 

SV10 (Level 2) Segment does not exist. 



SV1 1 (Level 2) Invalid segment-number (must range from 

-3 to 3?7R7^ 



SV21 (Level 2) Invalid visibility (must be or 1). 



ST20 (Level 2) The character specified has already been 
defined in this/o«r. 



SX SET-SEGMENT-POSITION = E cSX int xy 



ST21 (Level 2) Invalid character number (the range is 
from 32 to 126). 



SX02 (Level 3) Out of memory while performing com- 
mand. 



SU END-GRAPHTEXT-CHARACTER = E cSU 

SU03 (Level 1) This command is invalid at this time. (No 
graphtext character is being defined.) 



SX03 (Level 2) Command is invalid at this time (the spec- 
ified segment is currently being defined; 
4112, 4113, 41 15 only). 

SX1 (Level 2) Segment does not exist. 



SX11 (Level 2) Invalid segment-number (must range from 
-3 to 32767.) 

SX21 (Level 2) Invalid position (4112, 41 13, 4114, 4116: 
X = to 4095, Y = to 4095; 41 15: X = 
to 4095 or -2 31 to 2 31 -1 ; Y = to 4095 
or-2 31 to2 31 -1.) 
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SZ DELETE-GRAPHTEXT-CHARACTER = E cSZ int int TG SET-SURFACE-COLOR-MAP = E cTG int int-array 



SZ03 (Level 2) Command is invalid at this time, (A 

graphtext character is currently being 
defined.) 

SZ1 (Level 1 ) The specified font does not exist (no grid 
has been defined for that font). 



TGOO (Level 0) Unrecognized command. (The terminal is 
nota4112, 4113, or 41 15). 

TG1 (Level 2) Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 



SZ11 (Level 2) \nva\\d font-number (must range from -1 
to 32767). 



TG11 (Level 2) Invalid surface-number. (4112: -1, 1 to 3; 

A-\-\n- _a i t.-, A- 41 1 £■ _1 1 tnRl 



SZ20 (Level 1 ) The character specified does not exist in 
this font. 

o£<i i (i_evei £.) mvanu cnar-nutnuct . (ivmoi uc — i , ui nun i 
32 to 126.) 

TB SET-BACKGROUND-COLOR = E cTB int int int 

TB00 (Level 0) Unrecognized command (terminal is not a 
4112,4113, or 41 15). 

TB11 (Level 2) \nva\\d first-color-coordinate. (HLS mode: 
-32768 to 32767; RGB and CMY modes: 
to 1 00; 41 1 5 Machine RGB mode: to 
255.) 

TB21 (Level 2) Invalid second-color-coordinate (HLS, 
RGB, and CMY modes: to 100; 41 15 
Machine RGB mode: to 255). 

TB31 (Level 2) Invalid third-color-coordinate (HLS, RGB, 
and CMY modes: to 1 00 and 1 000 to 
1 1 00; 41 1 5 Machine RGB mode: to 255 
and 1000 to 1255). 



TG21 (Level 2) Invalid color-mixtures array. (The array 
count must be a multiple of four in the 
range from through 65532. The first int 
in each group be from to 32767. The 
other three ints must be valid HLS, RGB, 
or CMY values, according to the most 
recent SET-COLOR-MODE command. If 
the HLS system is in effect, the Hue 
parameter must be in the range from 
-32768 to + 32767, while the Lightness 
and Saturation parameters must be in the 
range from to 1 00. If the RGB or CMY 
system is in effect, then the first two color 
coordinates must be in the range to 100, 
and the third color coordinate must be in 
the range from to 1 00 or 1 000 to 1 1 00. 
In a 41 1 5, if the Machine RGB system is 
in effect, the first two color coordinates 
must be in the range from to 255, and 
the third color coordinate must be in the 
range from to 255 or 1 000 to 1 255.) 

TG22 (Level 3) Out of memory while parsing the 
parameter. 
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TM SET-COLOR-MODE = E cTM int int int 



UX SET-COORDINATE-MODE = E cUX int 



TMOO (Level 0): Unrecognized command (terminal is not a UX00 (Level 0) Unrecognized command. (Terminal is not 
4112,4113,or4115). a4115.) 

TM11 (Level2): Invalid color-specify-mode (41 12, 4113: UX11 (Level2) Invalid coordinate-mode (must be 0, 1, 
to 3; 41 15:0 to 4). or 2). 



TM21 (Level 2): Invalid color-overlay-mode (must range 
from to 3). 



UX21 (Level 2) Invalid int-report-size (must be 0, 
or 2 to 6). 



TM31 (Level 2): Invalid gray-mode (must be 0, 1 , or 2). 



UW SET-OVERVIEW-WINDOW = E cUW xy xy 



UB SET-DRAW-BOUNDARY-MODE = E cUB int 

UB00 (Level 0) Unrecognized command. (Terminal is not 
a 41 15.) 

UB1 1 (Level 2) Invalid draw-boundary-mode (must be 
or1). 

UR DRAW-RECTANGLE = E cUR xy-array 



UW00 (Level 0) Unrecognized command. (Terminal is not 
a4115.) 

UW11 (Level 2) Invalid absolute-lower-left parameter 
(both X and Y must be -2 31 to 2 31 -1). 

UW21 (Level 2) Invalid absolute-upper-right parameter 
(both X and Y must be -2 31 to 2 31 -1). 



UR00 (Level 0) Unrecognized command. (Terminal is not 
a4115.) 

UR1 1 (Level 2) Invalid opposite-corners array. (There 
must be an even number of xys in the 
array. Each xy must range from -2 31 to 
2 31 -1 ; array length must be from to 
65535.) 

UR12 (Level 3) Out of memory while parsing the 
parameter. 
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ANSI ERROR CODES 

°/o! SELECT-CODE = E c°/o! int 



%!00 (Level 0) Unrecognized command; terminal firm- 
ware is Version 3. 



°/o!11 (Level 2) Invalid command-set (must be or 1.) 

[@ INSERT-CHARACTER = CSIPn @ 

[@ 1 1 (Level 2) Invalid number-of-characters parameter 
(range is to 32767). 

[A CURSOR-UP = CSIPn A 

[All (Level 2) Invalid number-of-lines parameter (range 
is to 32767). 

[B CURSOR-DOWN = CS7PnB 

[B11 (Level 2) Invalid number-of-lines parameter (range 
is to 32767). 

[C CURSOR-FORWARD = CSI Pn C 

[C11 (Level 2) Invalid number-of-columns parameter 
(range is to 32767). 

[D CURSOR-BACKWARD = CSI PnO 

[D1 1 (Level 2) Invalid number-of-columns parameter 
(range is to 32767). 

[f HORIZONTAL-AND-VERTICAL-POSITION 

= CS7PnPnf 



[f11 (Level 2) Invalid line-number parameter (range is 
to 32767). 

[f21 (Level 2) Invalid column-number parameter (range 
is to 32767). 



[g TABULATION-CLEAR = CSI Psg 

[g1 1 (Level 2) Invalid tab-clear-extent parameter, (must 
be 0,1, or 2). 

[H CURSOR-POSITION = CSIPn Pn H 

[H11 (Level 2) Invalid line-number parameter (range is 
to 32767). 

[H21 (Level 2) Invalid column-number parameter (range 
is to 32767) 

[h SET-MODE = CSI Ps Ps . . . h 

[hi 1 (Level 2) Invalid mode value. 

[I CURSOR-HORIZONTAL-TAB = CSIPn I 

[111 (Level 2) Invalid value (range is to 32767). 

[J ERASE-IN-DISPLAY = CS/PsJ 

[J11 (Level 2) \nva\\<A erase-extent parameter (must be 0, 
1,or2). 

[K ERASE-IN-LINE = CSI PS K 

[K1 1 (Level 2) Invalid erase-extent parameter (must be 0, 
1,or2). 

[L INSERT-LINE = CSIPnL 

[L1 1 (Level 2) Invalid number-of-lines parameter (range 
is to 32767) 

[I RESET-MODE = CSI Ps Ps ... I 

[11 1 (Level 2) Invalid mode value. 
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[M DELETE-LINE = CS/Pn M 



ENABLE-MANUAL-INPUT = E cb 



[M11 (Level 2) Invalid number-of-lines parameter (range 
is to 32767). 

[m SELECT-GRAPHIC-RENDITION = CS/Ps Ps ... m 

[ml 1 (Level 2) Invalid rendition parameter (must be 0, 1 , 
4, 5, or 7). 

[n DEVICE-STATUS-REPORT = CS1 Psn 



No errors are detected for this command. 



c RESET-TO-INITIAL-STATE = E cc 



No errors are detected for this command. 



INDEX = E cD 



No errors are detected for this command. 



in 1 1 (Levei <t) invalid device parameter (the oniy valid 
device specifier is 6). 



E NEXT-LINE = E cE 



[P DELETE-CHARACTER = CS7PnP 



No errors are detected for this command. 



[P1 1 (Level 2) Invalid number-of-characters parameter 
(range is to 32767). 

[S SCROLL-DOWN = CS/Pn S 

[S11 (Level 2) Invalid number-of-lines parameter (range 
is to 32767). 



H HORIZONTAL-TAB-SET = E cH 



No errors are detected for this command. 



M REVERSE-INDEX = E cM 



No errors are detected for this command. 



[T SCROLL-DOWN = CS7PnT 



RESTORE-CURSOR = E c7 



[T1 1 (Level 2) Invalid number-of-lines parameter (range 
is to 32767). 

[X ERASE-CHARACTER = CS/Pn X 

[X1 1 (Level 2) Invalid number-of-characters parameter 
(range is to 32767). 

[Z CURSOR-BACKWARD-TAB = CS/Pn Z 

[Z1 1 (Level 2) Invalid number-of-tabs parameter (range 
is to 32767). 



No errors are detected for this command. 



8 RESTORE-CURSOR = E c8 



No errors are detected for this command. 



DISABLE-MANUAL-INPUT = E c' 



No errors are detected for this command. 
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Appendix D 
BIT PLANES AND SURFACES 



INTRODUCTION 

For a number of advanced applications, several 4112,4113, 
and 4115 commands let you specify Surface -1 . This is a 
Super Surface consisting of all bit planes of all surfaces cur- 
rently defined. To use the Super Surface properly, you 
should understand in detail the relationship between the ter- 
minal's bit planes and its writing surfaces. The bit planes 
are part of the terminal's hardware circuitry, while the writ- 
ing surfaces are artificial constructs accomplished by the 
terminal's firmware programming. 

This appendix explains these concepts. Topics included are: 

• The terminal's bit planes. 

• How the bit planes are grouped to form writing surfaces. 

• A definition of the Super Surface. 

• How the Super Surface might be used. 



BIT PLANES 

In the standard 41 1 3 terminal, and in a 41 1 2 equipped with 
Option 20, the terminal's raster memory is organized into 
three bit planes. (If a 41 1 2 does not have Option 20, it has 
only one bit plane. If a 41 1 3 is equipped with Option 21 , it 
has four bit planes. A 41 1 5 can have four, six, or eight bit 
planes.) For each pixel location on the screen, there is a 
one-bit memory cell in each of the bit planes. Figure D-1 
shows this. 

Refer now to Figure D-2 (for the 41 1 2) or Figure D-3 (for the 
4113). (The 4115 behaves like a 41 1 3.) To display informa- 
tion on the screen, circuitry in the terminal scans all bit 
planes simultaneously For each njxe! on the screen, the cir- 
cuitry reads one binary bit from each bit plane. All the bits 
for each pixel location form a binary word. In the 41 12, this 
word consists of one or three bits, depending on whether 
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Figure D-1 . Bit Planes. 
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Option 20 is installed. In the 41 1 3, the word has three or 
four bits, according to whether Option 21 is installed. In the 
41 15, the word can have four, six, or eight bits, according to 
whether Options 22 and 23 are installed or not. 



In the 41 1 2 (Figure D-2), the data read from the Video Map 
table goes to a DAC (Digital-to-Analog Converter), which 
converts it to an analog voltage to determine the brightness 
of the display. 



The circuitry takes each such pixel word and uses it as an 
index into a table (an address for a fast-access semiconduc- 
tor memory). In the 41 1 2, this table is the Video Map mem- 
ory on the 41 1 2 Raster Memory Board. In the 41 1 3 and 
4115, this table is the Color Map memory on the Color Map 
Board. 



In the 41 13 and 41 15 (Figure D-3), there are three DACs, 
one for each of the additive primary colors. Their outputs 
determine the brightnesses of the red, green, and blue 
phosphors for each pixel of the display. 
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Figure D-2, 4112 Hardware Display Circuitry. 
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Figure D-3. 4113 Hardware Display Circuitry. 
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SURFACES 

The "multiple writing surfaces" concept is used in many 
commands, including the following: 

SET-SURFACE-DEFINITIONS 

SET-SURFACE-PRIORITIES 

SET-SURFACE-VISIBILITY 

SET-SURFACE-GRAY-LEVELS 

SET-SURFACE-COLOR-MAP 

SET-VIEW-ATTRIBUTES 

BEGIN-PIXEL-OPERATIONS 

PIXEL-COPY 



In all these commands, the terminal's firmware program 
emulates the multiple writing surfaces by the way it writes 
into the 41 1 2 Video Map memory or the Color Map memory 
of the 41 13 and 41 15. 



AN EXAMPLE (4112 TERMINAL) 

Consider, for example, a 41 1 2 terminal which is equipped 
with three bit planes (Option 20). Figure D-4 shows the 
result of sending the following command to such a terminal: 

SET-SURFACE-DEFINITIONS: (1 ,2) 
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This command groups the terminal's three bit planes into 
two "writing surfaces." Surface 1 has a single bit plane, 
while Surface 2 has two bit planes. Surface 1 is in front of 
Surface 2, as shown in Figure D-4. 

To create an image on the display, the terminal scans the bit 
planes, obtaining from them a three-bit binary word for each 
pixel of the display. The most significant bit of this word is a 
color index (or "gray-index") for Surface 1 . The least-signif- 
icant two bits form the index for the same pixel location on 
Surface 2. 

In the 4112, index zero means "transparent." All non-zero 
indices are opaque. Thus, when a pixel's surface-one index 
is zero, that pixel's brightness is determined by the pixel's 
index for the surface behind it - Surface 2 in this example. 
But when a pixel's surface-one index is non-zero, the pixel's 
brightness depends only on that non-zero index; the index 
for Surface 2 is irrelevant, since Surface 2 is behind Surface 
1 . (Any images on Surface 2 are obscured by images on 
Surface 1 .) 

AN EXAMPLE (41 1 3 TERMINAL) 

Figure D-5 shows a corresponding example for a 41 1 3 ter- 
minal equipped with four bit planes (Option 21). The illustra- 
tion shows the result of the following commands: 

SET-BACKGROUND-GRAY-LEVEL: 
SET-COLOR-MODE: 0, 1 , 1 
SET-SURFACE-DEFINITIONS: (2,2) 

Here, the SET-COLOR-MODE command's second parame- 
ter is 1 . This specifies "OPAQUE mode," in which images 
on the front surface obscure images drawn on surfaces 
behind. The SET-SURFACE-DEFINITIONS command allo- 
cates the terminal's four bit planes among two writing sur- 
faces. Surface 1 has two bit planes, and so does Surface 2. 

Thus, the most-significant two bits for each pixel word com- 
prise a color index for Surface one, while the least-signifi- 
cant two bits comprise a color index for Surface 2. That is, 
the Color Map memory's most-significant address bits rep- 
resent a surface-one color index, while its least-signficant 
two address bits represent a surface-two color index. 

In Figure D-5 , the Color Map memory is shown with the 

default color mixtures, as set by the SET-SURFACE- 
DEFINITIONS command: 

Index 0: Transparent (look through to the surface behind) 

Index 1 : White (full brightness on all three DACs) 

Index 2: Red 

Index 3: Green 



Since OPAQUE mode is in effect, any non-zero index on 
Surface 1 obscures any index behind it on Surface 2. For 
instance, whenever a pixel's surface-one index is 1 (binary 
01), the pixel is displayed in the "white" color mixture, 
regardless of the surface-two color index for that pixel. (The 
red, green, and blue brightnesses are at their maximums.) 

Likewise, when the surface-one index is 2 (binary 10), the 
pixel is red; the red brightness is at its maximum, while the 
green and blue brightnesses are zero. Again, when the sur- 
face-one color index is 3 (binary 11), the pixel is blue only 
the blue DAC is turned on. 

If the surface-one index is zero (transparent), then we look 
through Surface 1 to see what may be drawn on Surface two 
behind it. For instance, when the surface-one color index is 
zero and the surface-two color index is 1 , the pixel is white. 
Again, when the surface-one index is zero and the surface- 
two index is 2, the pixel is red. 

When both color indices are zero, we see the background 
color. (This situation is represented by the first entry in the 
Color Map table.) 

MANIPULATING SURFACES 

The commands which manipulate surfaces do so by re- 
arranging the data in the 41 1 2 Video Map memory or the 
41 1 3 and 4115 Color Map memory. Thus, all of the following 
commands affect the data in the Video Map or Color Map 
memory: 

SET-SURFACE-DEFINITIONS 

SET-SURFACE-PRIORITIES 

SET-SURFACE-VISIBILITY 

SET-SURFACE-GRAY-LEVELS 

SET-SURFACE-COLOR-MAP 

SET-COLOR-MODE 

For instance, a SET-SURFACE-PRIORITIES command can 
place Surface 2 "in front of" Surface 1 . Figure D-6 shows 
the result of such a command on a 41 1 3 terminal. With Sur- 
face 2 in front of Surface one, the surface-two index takes 
priority over the surface-one index. Thus, compared to Fig- 
ure D-5, the Color Map table in Figure D-6 is rearranged. 
For instance, whenever a pixel's surface-two index is 1 , that 
pixel is displayed as white, regardless of the surface-one 
index. 



41 10 SERIES COMMAND REFERENCE 



D-5 



o 

I 



4113 COLOR MAP MEMORY 



-set-surf ace-definitions; (2.2); 
= (ESC)(R)(D)(2)(2)(2). 



llw sHi-iurfm-«s-d*;{iriuoii r . con^rar;: po.i::js 
two surfaces. Surface one is "in front of" 
surface two. That is. in OPAOUE color mode, 

surface one color-indices take priority over 
surface two indices. 

For instance, whenever the surface 1 
color-index is 3 (binary 1 1 ). the pixel 
is displayed in green color. 
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Figure D-5. Emulating Two Writing Surfaces in the 41 13 Terminal. 
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•set surface-priorities: (1,2 2,1 ) 
= (FSO)(R)(N)(4)(i)(2)(?H' ! )- ' 



A «- 5Qi-s'jrfai;e-priorities> command has 
rearranged the color map so that surface two 
color-indices take priority over surface one 

indices. 

For instance, whenever the surface two 

indox is 3 (b'iiary 1 1 ), the pwetf is 
displayed in tjreen color. 
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Figure D-6. Effect of Changing the Surface Priorities. 
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THE SUPER SURFACE 

A few of the terminal's commands let you specify Surface 
-1 . This is a Super Surface, consisting of all bit planes in all 
surfaces currently defined. Figure D-7 shows the concept. 

In a color index for a pixel of the Super Surface, the most- 
significant bit is the same as the most-significant bit in that 
pixel's surface-one color index. The least-significant bit in 
the super-surface index is the same as the least-significant 
bit in the color index for the highest-numbered surface. 

Let us suppose, as in Figure D-7 , that there are two sur- 
faces of two bit planes each. Then if a pixel's "super-sur- 
face color index" is 9 (binary 1001). that means that the 
pixel's surface-one index is 2 (binary 10) and its surface-two 
index is 1 (binary 01). 



To restore the image from the file F0:SCREEN, you LOAD 
the file back into the terminal. When doing so, however, be 
sure that the terminal is set as it was when the file was cre- 
ated with the SAVE command. That is, the terminal should 
have the same number of surfaces as when the file was cre- 
ated, with the same number of bit planes for each surface. 
Also, the background color, and the color mixtures for each 
surface's color indices, should be the same as when the file 
was created. 

Under those circumstances, the image on the screen can 
be restored with a LOAD command: 

LOAD: F0:SCREEN 



CHANGING THE EFFECT 
OF OVERLAPPING COLORS 



USING THE SUPER SURFACE 

The following examples show how the Super Surface might 
be used. 



SAVING THE SCREEN DISPLAY 
ON A DISK FILE 

Suppose that the terminal has three bit planes. (That is, the 
terminal is a standard 41 1 3, or a 41 1 2 equipped with Option 
20.) In that case, the following commands save the entire 
contents of the screen on a disk file. The contents of all 
viewports, on all writing surfaces are saved; this includes 
the dialog viewport, if the dialog area is visible. BEGIN- 
PIXEL-OPERATIONS: -1,11,3 SET-PIXEL-VIEWPORT: 
(0,0), (639,479)SAVE: RUN, -1 , TO, F0:SCREEN. 

Here, the BEGIN-PIXEL-OPERATIONS command specifies 
the Super Surface as the surface on which the pixel view- 
port is located. Also specified are ALU mode 1 1 (Set mode), 
and three bits per pixel. 

The SET-PIXEL-VIEWPORT command sets the pixel view- 
port to occupy all of raster memory space. This is the 
default value for the pixel viewport, so this command need 
not be issued if the pixel viewport has not been changed 
since power-up. 

The SAVE command specifies that the entire contents of the 
pixel viewport are to be saved using RUNLENGTH-WRITE 
commands on the file named SCREEN on Disk Drive 0. 



The SET-SURFACE-COLOR-MODE command lets you 
specify three different "overlay modes," or ways of repre- 
senting parts of the screen where images on one surface 
overlay images on another surface; OPAQUE, SUBTRAC- 
TIVE and ADDITIVE. In OPAQUE mode, images on "front" 
surfaces obscure images on surfaces behind. In SUBTRAC- 
TIVE mode, the images are drawn a though the terminal 
were a light table and the images were translucent. In ADDI- 
TIVE mode, the colors of the images in the "front" surface 
combine with the colors on the "back" surfaces to create 
new colors for the front surface images. 

However, suppose none of these modes satisfy you. For 
instance, suppose you have been using the terminal to 
emulate multiple overlays on a light table. There are two 
surfaces, of two bit planes each, and the overlay mode 
(SET-COLOR-MODE command) is SUBTRACTIVE. The 
color-mixtures are set as follows: 

Surface Color ir 



1 







1 




2 


100 


3 


2 







1 




2 




3 


Backgrou 


md 



[Color-Mixture 


HLS 








Coordinates 




H 


L 


s 


Transparent 


— 


— 


— 


Red 


120 


50 


100 


Green 


240 


50 


100 


Dark 


Blue 





50 


Transparent 


— 


— 


— 


Red 


120 


50 


100 


Green 


240 


50 


100 


Blue 





50 


100 


White 





100 






D-8 



4110 SERIES COMMAND REFERENCE 



o 

co 
m 

m 

CO 

o 
O 



o 

D 

m 

Tl 

m 
u 
m 
z 
o 
m 



<* I 13 COLOR WAP MEMORY 



SUPER-SURFACE COLOR-INDEX 

*~ A 



SURFACE 1 SURFACE 2 
COLOR-INDEX COLOR-INDEX 



RED 
BRIGHTNESS 















I-+-0 









1 

1 
1 1 


1 

1 
1 1 






1 

1 

1 1 



ADDRESS 





^B-iiv-HSg 


A- 




' 






SUPER' 
SURFACE \. 


/"SURFACE 2/ 


I / 





















^SURFACE 


iV 


1 
/ 






BITP 
















PIXEL 

BEING SCANNED 




BIT PLANE 1 




BIT PLAN 


E2 




BITP 


LANE 3 





















































































v- 





RED 
DAC 



GREEN 
BRIGHTNESS 







1111 























1111 



1111 



1111 



1111 



— v — 
DATA 



GREEN 
DAC 



DIGITAL TO 

ANALOG 

CONVERTERS 



BLUE 
BRIGHTNESS 






1111 








1111 


1111 


1111 


1111 



























BLUE 
DAC 



DISPLAY 



1S56B-12 



o 



Figure D-7. The Super Surface in the 411 3. 
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If you try this, you will find that whenever a red region on 
one surface overlays a green region on the other surface, 
the pixels in the region of overlap are black. This is also the 
case whenever red overlays blue, or blue overlays green. 

With the SET-SURFACE-COLOR-MAP command, you can 
specify a particular color mixture for each combination of 
colors on the two surfaces. That is, you set the terminal's 
Color Map table exactly as you wish, for all overlay possibili- 
ties. That way, you can specify one color mixture when red 
overlays green, another when green overlays red, and yet 
another when red overlays blue. 

To do this, you first decide exactly what color-mixture you 
want for every overlay combination, and prepare a table 
accordingly. Then, you issue a SET-SURFACE-COLOR- 
MAP command for "surface minus one," setting the Color 
Map memory to match your table. 

Suppose, for instance, that your table is like Table D-1 : 



Table D-1 
A SET OF COLOR OVERLAY COMBINATIONS 



Combination 
of Overlay 


Color Indices 


Super Surface 
Color Mixture 


Color 


Surface 
One 


Surface 
Two 


Super 
Surface 


H 


L 


S 


Background 



(00) 



(00) 



(0000) 


White 



100 





Red on 
surface 2 



(00) 


1 

(01) 


1 

(0001) 


Light 

Red 

120 


67 


100 


Green 

on surface 2 



(00) 


2 
(10) 


2 
(0010) 


Light 

Green 

240 


67 


100 


Blue on 
surface 2 



(00) 


3 


3 
(0011) 


Light 
Blue 



67 


100 


Red on 
surface 1 


1 
(01) 



(00) 


4 
(0100) 


Light 

Red 

120 


67 


100 


Red over 
red 


1 

(01) 


1 
(01) 


5 
(0101) 


Dark 
Red 
120 


33 


100 


Red over 
green 


1 
(01) 


2 
(10) 


6 
(0110) 


Dark 
Gray 



33 





Red 
over blue 


1 

(01) 


3 

(11) 


7 
(0111) 


Darker 

Gray 




15 





Green on 
surface one 


2 
(10) 




(00) 


8 
(1000) 


Light 

Green 
240 


67 


100 


Green over 
red 


2 

(10) 


1 

(01) 


9 

(1001) 


Dark 
Gray 



33 





Green over 
green 


2 

(10) 


2 
(10) 


10 
(1010) 


Dark 

Green 

240 


33 


100 


Green over 
blue 


2 
(10) 


3 
(11) 


11 

(1011) 


Darker 

Gray 




15 





Blue on 
surface one 


3 
OD 



(00) 


12 
(1100) 


Light 
Blue 



67 


100 


Blue over 
red 


3 
(11) 


1 
(01) 


13 
(1101) 


Darker 

Gray 




15 





Blue over 
green 


3 

OD 


2 
(10) 


14 
(1110) 


Darker 

Gray 




15 





Blue over 
blue 


3 

(11) 


3 

(11) 


15 
(1111) 


Dark 

Blue 



33 


100 
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To achieve these color overlay combinations, you would 
define the super-surface color mixtures as in Table D-2: 



Table D-2 
SOME SUPER-SURFACE COLOR MIXTURES 



Color Index 


Color Mixture 




H 


L 


S 








100 





1 


120 


67 


100 


2 


240 


67 


100 


3 





67 


100 


4 


120 


67 


100 


5 


120 


33 


100 


6 





33 


100 


7 





15 


100 


8 


240 


67 


100 


9 





33 





10 


240 


33 


1UU 


11 





15 





12 





67 


100 


13 





15 


n 


14 





15 





15 





33 


100 



Once having completed the table, you can compose a SET- 
SURFACE-COLOR-MAP command to load the Color Map 
memory in accordance with your table. (In this command, 
"index 0" can be used to specify the background color.) 



SET-SURFACE-COLOR-MAP: -1 , color-mixtures-array 

= E cTG 

int: -1 
int: 64 

int: int: int: int: 
int: 1 int: 120 int: 67 int: 100 
int: 2 int: 240 int: 67 int: 100 
int: 3 int: int: 67 int: 100 
int: 4 int: 120 int: 67 int: 100 
int: 5 int: 120 int: 33 int: 100 
int: 6 int: inf. 33 int: 100 
int: 7 int: int: 15 int: 100 
int: 8 int: 240 int: 67 int: 100 
int: 9 int: int: 33 int: 
int: 10 int: 240 int: 33 int: 100 
int: 11 int: int: 15 int: 
int: 12 int: int: 67 int: 100 
int: 13 int: int: 15 int: 
int: 14 int: int: 15 int: 
int: 1 5 int: int: 33 int: 100 

= E cTG! 

D4000001G8D3F4 
2O0D3F430O0F4 
4G8D3F45G8B1 F4 
60B1F4707F4 
8O0D3F490B10 
:O0B1 F4;0?0 
<0D3F4 = 0?0 
>0?0?0B1F4 



41 10 SERIES COMMAND REFERENCE 



D-11 



BIT PLANES AND SURFACES 



Special Considerations 

Setting color mixtures on the super surface affects only the 
terminal's Color Map memory. It does not affect other por- 
tions of the terminal's memory, such as tables recording the 
color mixtures for each surface. This results in the following 
limitations of the super surface: 

• The REPORT-TERMINAL-SETTINGS command cannot 
be used to learn the color mixtures on the super surface. 
(You can learn the color mixtures on the background, 
and surfaces 1 , 2, etc., but not the super-surface colors.) 
This is because the terminal doesn't "remember" the 
color mixtures on the super surface (except in the Color 
Map memory, which is part of the display hardware and 

> rr* a t> r» r\ *\ 



• Any command which writes to the color map memory will 
wipe out the effect of an earlier SET-SURFACE-COLOR- 
MAP command for the super surface. Therefore, after 
defining color mixtures for the super surface, you should 
avoid issuing any of these commands: 

SET-SURFACE-DEFINITIONS 

SET-SURFACE-PRIORITIES 

SET-SURFACE-VISIBILITY 

SET-SURFACE-GRAY-LEVELS 

SET-SURFACE-COLOR-MAP 

SET-COLOR-MODE 

SET-BACKGROUND-GRAY-LEVEL 

SET-BACKGROUND-COLOR 
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Appendix E 



COLOR COORDiNATES 



At any one time, a 41 1 3 or 41 1 5 terminal can display only a 
limited number of colors. However, you can select which 
colors to use from a palate of 4096 color mixtures for the 
41 1 3, and from a palate of four billion color mixtures on the 
41 15. To select a particular color mapping, use the SET- 
BACKGROUND-COLOR and SET-SURFACE-COLOR-MAP 
commands, which are described in Section 7. 

In these commands, you specify a particular color mixture 
using one of the following color coordinate systems: 

• RGB (Red, Green, Blue) 

• CMY (Cyan, Magenta, Yellow) 

• HLS (Hue, Lightness, Saturation) 

• Machine RGB (41 15 only) 

SET-COLOR-MODE COMMAND 

On power-up, the termimal is set to use the HLS system. 
You can select other coordinate systems with the SET- 
COLOR-MODE command (the Setup mode name for this 
command is CMODE. 

SET-COLOR-MODE 

= E cTM \ntcolor-specifying-mode 
mV.color-overlay-mode 
\n\:gray-mode 

The first parameter, color-specif ying-mode, is 1 to select the 
RGB color coordinate system, 2 to select the CMY system, 
3 to select the HLS system, or 4 to select tha Machine RGB 
system on a 41 1 5 terminal. If this parameter is zero, the 
color-specifying-mode is left unchanged. 

(For information about the other two parameters, see the 
description in Section 7 of the SET-COLOR-MODE 
command.) 



RGB COORDINATE SYSTEM 

In the RGB color coordinate system, you specify a color 
mixture as percentages of red, green, and blue, in that 
order. Each color coordinate is an integer in the range from 
to 100. 

For instance, one way to set the background color to red is 
to issue these commands: 

• SET-COLOR-MODE: 1,0,1. Selects the RGB color coor- 
HjnQtQ circtam i i_gg>\ a /g th@ n\/@rjo\/ mrtHg unchan n ed but 
set the gray mode to "COL" to ensure that the display is 
In color rather than in black and white. 

• SET-BACKGROUND-COLOR: 100,0,0. Sets the 
intensities of the red, green, and blue electron beams to 
100%, 0%, and 0% of their maximum values, respec- 
tively. Likewise, you can set color index one on surface 
number three to "green," as follows: 

• SET-COLOR-MODE: 1,0,1. Selects RGB color 
coordinates. 

• SET-SURFACE-COLOR-MAP: 1 ,(1 ,0,100,0) Sets the 
color mixture for surface one, color index one, as follows: 
0% red, 100% green, 0% blue. 

In Setup mode, these latter two commands are typed as 
follows: 

CMODE 1 
CMAP1 10100 

From the host computer, these same commands are sent as 
escape sequences: 

SET-COLOR-MODE: 1,0,1 
= E cTMint:1 int:0int:1 
= E cTM101 

SET-SURFACE-COLOR-MAP: 1, (1,0,100,0)> 
= E cTGint:1 int-array:(1, 0,1 00,0) 
= E cTG int:1 int:4 int:1 int:0 int:100 int: 
= E cTG1410F40 
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COLOR COORDINATES 



CMY COORDINATE SYSTEM 



HLS COORDINATE SYSTEM 



In the CMY system, the three color coordinates are percent- 
ages percentages of cyan, magenta, and yellow pigments. 
Each coordinate is an integer in the range from to 1 00. 

(The additive primaries — red, green, and blue — are used 
when mixing lights to produce color mixtures. The subtrac- 
tive primaries — cyan, magenta, and yellow — are used 
when mixing pigments.) 

The CMY coordinates are related to the RGB coordinates as 
follows: 

C = 100- R 
M = 100-G 
Y = 100 -B 

For instance, you can use the following commands can be 
used to select a red background color: 

• SET-COLOR-MODE: 2, 0, 1 . Selects the CMY coordinate 
system, while leaving the overlay mode unchanged and 
setting the gray mode to "color" rather than "black and 
white." 

• SET-BACKGROUND-COLOR: 0,100,100. Mixes pig- 
ments of 0% cyan, 1 00% magenta, and 1 00% yellow to 
produce a "red" color mixture. 

In Setup mode, the operator can type these commands as 
follows: 

CMODECMY 
E cTB0100100 

(There is no Setup mode name for the SET-BACKGROUND- 
COLOR command, so in Setup mode the operator must use 
the escape-sequence op code for that command.) 

The same two commands can be sent from the host 
computer as escape sequences: 

SET-COLOR-MODE: 2,0,0 
= E cTM int:2 int:0 int:0 
= E cTM200 



In the HLS coordinate system, the universe of possible color 
mixtures is represented as a double-ended cone (Figure 
E-1). The three coordinates are H (hue), L (lightness), and 
S (saturation). 



Hue. The hue coordinate runs around the cone, from to 
360 degrees: 



Hue Coordinate 


Color Name 





Blue 


60 


Magenta 


120 


Red 


150 


Orange (red-yellow) 


180 


Yellow 


240 


Green 


300 


Cyan 



Lightness. The lightness coordinate runs up the cone, from 
black at the bottom (0% lightness) to white at the top (100% 
lightness). 



Saturation. The saturation coordinate expresses the 
degree to which a color mixture differs from a shade of gray. 
This coordinate runs radially outward from the axis of the 
HLS cone. It is expresses as a percentage of the maximum 
saturation that is possible at a given lightness level. The 
most fully saturated color mixtures are at the 50% lightness 
level, where the double-ended cone is widest. 

In the HLS coordinate system, all "red" color mixtures have 
the same hue angle. For instance, "dark red," "fully satu- 
rated red," and "light red" differ only in the lightness 
coordinate: 



Color Name 


H 


L 


S 


Dark Red 


120 


33 


100 


Fully Saturated Red 


120 


50 


100 


Light Red 


120 


67 


100 



SET-BACKGROUND-COLOR: 0,100,100 
= E cTBint:0int:100int:100 
= E cTB0F4F4 
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100% — 



In the HLS color coordinate system 
the color space is represented as a 
double-ended cone. 

The HUE coordinate runs 
counterclockwise around the 
cone. (0 to 360 degrees 

The LIGHTNESS coordinate runs 
vertically up the cone. (0% to 100% 

The SATURATION coordinate runs 
radially outward from the axis of 
the cone. The SATURATION coordinate 
is a percentage of the maximum 
possible saturation at a particular -|80° 
LIGHTNESS level. (0%to 100% 



HUE 



NOTE: For clarity, this figure shows the 
cone divided into only 64 colors, as in 
the TEKTRONIX 4027 terminal. The 
41 1 3 and 41 1 5 terminals have a wider 
range of color mixtures; for the 41 13 
and 41 1 5, the HLS cone is divided into 
4096 distinct cells. 



Figure E-1 . HLS Color Cone 
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Overview: 

The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that "color theory" is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ics. 

In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 

Color Concepts: 

Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 



Saturation: The characteristic which 

describes the extent to 
which a color differs from 
a gray of the same light- 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 0% (maxi- 
mum white content at that 
lightness level) to 100% 
(full saturated). 

Geometrically, colors can be described in 
terms of a double cone. 
Variations in lightness are represented 
along the axis, with white at the apex of 
the cone and black at the opposite apex. 
Variations in saturation are represented by 
radial distances from the lightness axis, in 
constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 



Hue: 



Lightness: 



The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from to 360. 

The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from to 100% 
with black being (bot- 
tom of cone) and white 
being 1 00% (top of cone). 
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COLOR COORDINATES 



Likwise, you can get light-colored mixtures of different hues 
by setting the lightness coordinate to a relatively large value 
and varying only the hue coordinate: 

Color Name H L S 



Light Red 
Light Orange 
Light Yellow 
Light Green 
Light Blue 



Again, different mixtures of a given color with gray can be 
achieved by varying only the saturation coordinate: 

Color Name H L S 
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MACHINE RGB COORDINATE SYSTEM 

Machine RGB mode is only available on 41 1 5 terminals. It 
behaves like regular RGB mode, except instead of being 
limited to 100 units in each color direction (red, green, and 
blue), 256 units are available in each direction. 

Since there are 256 colors allowed at any one time on the 
display, the finer divisions allow you to tune more finely the 
colors on a 41 1 5 terminal. 
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50 
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50% Gray 

Grayish Red 

Fully Saturated Red 



For instance, to set the color index 2 on surface 1 to a light 
shade of green, you could issue these commands: 

SET-COLOR-MODE: 3,0,1 

Select the HLS color coordinate system, while leaving the 
overlay mode unchanged and setting the gray mode so that 
the display is in color rather than in black and white. 

SET-SURFACE-COLOR-MAP: 1 ,(2,240,67,100) 

Set the color mixture for surface one, color index two, as 
follows: a green hue (H = 240), of a light shade (L = 67), with 
the maximum saturation possible at that lightness level 
(S = 100). 

For more information on the SET-COLOR-MODE and SET- 
SURFACE-COLOR-MAP commands, see their descriptions 
in Section 7. 
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Table F-1 shows the 41 1 5 default color index values in RGB coordinates. 

Table F-1 
41 15 DEFAULT COLORS 



Index 


R 


G 


B 














1 


100 


100 


100 


2 


100 








3 





100 





4 








100 


5 





100 


100 


6 


100 





83 


7 


100 


100 





8 


100 


50 





9 


60 


83 





10 





100 


60 


11 





50 


100 


12 


55 





83 


13 


100 





55 


14 


33 


33 


33 


15 


67 


67 


67 


16 


100 


100 


33 


17 


75 


100 


45 


18 


45 


100 


60 


19 


17 


100 


75 


20 


25 


83 


83 


21 


50 


67 


83 


22 


75 


55 


83 


23 


100 


33 


90 


24 


67 


90 


45 


25 


40 


90 


KC 


26 


17 


90 


67 


27 


17 


67 


90 


28 


17 


50 


100 


29 


45 


33 


100 


30 


75 


17 


100 


31 


90 


9 


100 


32 


83 


100 


17 


33 


67 


100 


25 


34 


45 


100 


33 


35 


17 


100 


50 


36 


17 


83 


60 


37 


17 


67 


75 


38 


17 


55 


83 


39 


25 


45 


90 


40 


40 


33 


90 



Index 


R 


G 


B 


41 


67 


17 


90 


42 


83 


17 


83 


43 


90 


33 


67 


44 


83 


45 


60 


45 


83 


60 


50 


46 


90 


67 


40 


47 


90 


67 


25 


48 


100 


90 


9 


49 


83 


100 


9 


50 


60 


100 


17 


51 


45 


100 


25 


52 


17 


90 


45 


53 


17 


83 


55 


54 


17 


67 


67 


55 


17 


55 


75 


56 


17 


40 


90 


57 


40 


25 


90 


58 


55 


17 


90 


59 


83 


17 


75 


60 


100 


17 


67 


61 


100 


25 


60 


62 


100 


40 


50 


63 


100 


50 


40 


64 


100 


83 


9 


65 


75 


100 





66 


60 


100 


13 


67 


40 


100 


17 


68 


13 


100 


33 


69 


13 


83 


45 


70 


17 


75 


50 


71 


13 


60 


67 


72 


13 


50 


75 


73 


13 


40 


83 


74 


17 


25 


90 


75 


17 


17 


100 


76 


33 


9 


100 


77 


55 


9 


90 


78 


75 





83 


79 


90 





75 


80 


90 


75 


9 


81 


67 


90 


9 



41 1 SERIES COMMAND REFERENCE 



F-1 



41 15 COLOR MAP 



Table F-1 (cont) 
41 15 DEFAULT COLORS 



Index 


R 


G 


B 


82 


55 


90 


13 


83 


25 


90 


25 


84 


13 


90 


33 


85 


17 


75 


40 


86 


13 


67 


50 


87 


13 


55 


60 


88 


13 


45 


67 


89 


17 


33 


75 


90 


17 


25 


83 


91 


33 


17 


83 


92 


55 


13 


75 


93 


75 


13 


67 


94 


90 


17 


55 


95 


83 


25 


50 


96 


83 


75 





97 


60 


83 


9 


98 


45 


90 


9 


99 


33 


90 


13 


100 


13 


90 


25 


101 


17 


83 


25 


102 


17 


75 


33 


103 


17 


60 


45 


104 


13 


50 


55 


105 


13 


45 


60 


106 


17 


33 


67 


107 


33 


25 


67 


108 


45 


25 


60 


109 


67 


25 


50 


110 


83 


25 


40 


111 


100 


25 


33 


112 


75 


67 





113 


55 


75 


9 


114 


40 


83 


9 


115 


25 


90 


9 


116 


17 


90 


13 


117 


17 


83 


17 


118 


13 


75 


25 


119 


13 


67 


33 


120 


13 


60 


40 


121 


13 


45 


50 


122 


13 


40 


55 


123 


25 


33 


55 


124 


45 


33 


45 


125 


55 


33 


40 


126 


67 


33 


33 


127 


83 


33 


25 


128 


67 


60 





129 


50 


67 


9 


130 


40 


67 


13 



Index 


R 


G 


B 


131 


25 


67 


17 


132 


13 


67 


25 


133 


9 


60 


33 


134 


9 


50 


40 


135 


13 


40 


45 


136 


13 


33 


50 


137 


9 


17 


67 


138 


17 


13 


67 


139 


40 


13 


55 


140 


50 


13 


50 


141 


60 


13 


45 


142 


75 


13 


40 


143 


90 


13 


33 


144 


55 


50 


9 


145 


45 


60 


9 


146 


33 


60 


13 


147 


17 


60 


17 


148 


9 


55 


25 


149 


13 


45 


33 


150 


9 


40 


40 


151 


17 


33 


40 


152 


17 


25 


45 


153 


25 


17 


50 


154 


25 


13 


55 


155 


33 


13 


50 


156 


45 


13 


45 


157 


55 


13 


40 


158 


67 


13 


33 


159 


83 


13 


25 


160 


50 


45 


9 


161 


40 


50 


9 


162 


33 


60 





163 


17 


60 


9 


164 


13 


67 


9 


165 


13 


60 


13 


166 


13 


50 


17 


167 


9 


45 


25 


168 


13 


40 


25 


169 


13 


33 


33 


170 


9 


25 


40 


171 


9 


17 


50 


172 


9 


13 


55 


173 


13 





60 


174 


33 





50 


175 


50 





40 


176 


75 


33 





177 


67 


40 





178 


55 


40 


9 


179 


33 


40 


17 
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41 15 DEFAULT COLORS 
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Index 


R 


G 


B 


180 


25 


33 


25 


181 


25 


25 


33 


182 


25 


17 


40 


183 


33 


13 


40 


184 


50 


13 


33 


185 


60 


13 


25 


186 


75 


9 


25 


187 


83 





25 


188 


100 





17 


189 


100 


13 


13 


190 


90 


17 


9 


191 


83 


25 


9 


192 


60 


25 





193 


45 


40 







25 


40 


13 


195 


25 


33 


17 


196 


17 


25 


25 


197 


17 


17 


33 


198 


25 


13 


33 


199 


33 


9 


33 


200 


50 


9 


25 


201 


67 


9 


17 


202 


83 





17 


203 


90 





13 


204 


100 





9 


205 


100 


13 


9 


206 


83 


17 





207 


75 


25 





208 


50 


17 





209 


40 


33 





210 


13 


45 


9 


211 


9 


40 


13 


212 


9 


33 


17 


213 


9 


25 


25 


214 


13 


17 


33 


215 


17 


9 


40 


216 


25 





33 


217 


45 





25 



Index 


R 


G 


B 


218 


60 





17 


219 


75 





13 


220 


83 





9 


221 


75 


9 


8 


222 


67 


13 


9 


223 


60 


17 





224 


40 


17 





225 


17 


33 





226 


9 


33 





227 


9 


25 


9 


228 


9 


17 


13 


229 


9 


13 


25 


230 


9 


13 


33 


231 


9 





33 


232 


10 





25 


233 


17 





17 


234 


33 





17 


235 


33 





13 


236 


40 





9 


237 


45 


9 


9 


238 


45 


13 





239 


17 


9 





240 


25 


13 





241 


13 


13 





242 


9 


13 





243 


9 


13 


9 


244 


9 


13 


13 


245 





13 


13 


246 


9 


9 


13 


247 


13 





13 


248 


13 





17 


249 


17 





13 


250 


17 





9 


251 


25 





9 


252 


33 





9 


253 


45 


9 





254 


25 


9 





255 


13 


9 
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